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.

Work With Tasks

Tasks are small units of work with status, owner, priority, and history.

List tasks

todos list

Add task

todos add "Fix production health check"

Show details

todos show <task-id>

Start work

todos start <task-id>

Mark done

todos done <task-id>

Field	Use
Title	The outcome.
Description	The context.
Priority	What should happen first.
Status	Pending, in progress, blocked, or done.
Comments	Decisions and verification notes.