todos.md

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