todos.mdAgent Integrations
todos.md gives agents a task API they can trust. Agents should read the backlog, claim work, update status, and report what changed.
Supported hosts
| Agent | Expected setup |
|---|---|
| Codex | CLI or MCP access to the hosted workspace. |
| Claude Code | MCP access with task and run tools. |
| Gemini | MCP access and remote discovery. |
| Cursor | CLI/API token for project work. |
| OpenCode | MCP registration through the host config. |
| MCP hosts | Any host that can call the todos MCP gateway. |
Check available surfaces
Catalog
todos docs catalog --surface mcpAgent flow
- Read the current task list.
- Claim one task.
- Work in the repo.
- Add comments when state changes.
- Mark the task done only after verification.
MCP tools
The MCP gateway should expose tasks, projects, runs, feedback, docs, and organization context from the same API as the CLI.