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.

Build On The API

Build integrations against the hosted API without breaking the open source boundary.

Contract

A production integration should define:

Which organization it acts in.
Which API key or session it uses.
Which endpoints it calls.
What it writes.
How it reports errors.
How users can revoke access.

Keep the boundary clean

The open source todos package remains the local runtime. todos.md is the hosted control plane.

Validate before release

List API catalog

todos docs catalog --surface api

Call the API

todos api get /api/v1/capabilities

Documentation expectations

Good docs show the command, required auth, expected output, limits, and failure modes. Keep the words plain.

bun install -g @hasna/todos