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.

Hosted Runs

Hosted runs let agents do longer work while todos.md keeps status, logs, and artifacts.

List runs

todos api get /api/v1/runs

Create a run

todos api post /api/v1/runs/example-capability

Each run can export files:

.todos/
  exports/
    run_01hy...
      manifest.json
      receipt.json
      result.json

Long jobs should be resumable by run id.

Check status

todos api get /api/v1/runs/<run-id>