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.

Quickstart

This path gets a new machine from zero to a local, agent-readable task workspace. It does not require a web dashboard or hosted account.

Install the CLI

Install the package once on the machine.

Install
bun install -g @hasna/todos

Bootstrap the repo

Register the current repo as the task workspace.

Bootstrap project
todos project-bootstrap . --name launch

Check the workspace

Confirm the local task state and current project.

Status
todos status
Projects
todos projects list

Create a task

Add work with a short title. Keep it clear.

Add task
todos add "Ship production smoke test" --project launch

Move the task

Start it, finish it, and inspect the result.

List tasks
todos list
Start task
todos start <task-id>
Done
todos done <task-id>

What success looks like

After setup, agents can see the backlog, claim work, update status, and leave a trail people can understand.

bun install -g @hasna/todos