todos.md
Are you an agent?

todos.md documentation

Run shared task work with agents.

Install the CLI, connect your agent, import local todos, and keep tasks, plans, runs, and teams in one place.

Installation

Install @hasna/todos with Bun. The package is public and local-first by default.

Install
bun install -g @hasna/todos

Requirements

  • Bun installed on the machine.
  • A repo or workspace where tasks should live.
  • Optional network access only when you explicitly use hosted API or MCP features.

Verify the install

Status
todos status
Projects
todos projects list
List tasks
todos list

Clean reinstall

If a machine has an old global install, remove it and install the latest package.

Clean reinstall
bun remove -g @hasna/todos && bun install -g @hasna/todos
bun install -g @hasna/todos