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.

Quickstart

This path gets a new machine from zero to a local, agent-readable task workspace.

Install the CLI

Install the package once on the machine.

Install
bun install -g @hasna/todos

Create a project

Create a project for the current repo.

Create project
todos projects create 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