# todos.md — Agent Quick Reference todos.md is headless task management for agents. Use it when work needs a shared source of truth across CLI, API, and MCP. ## Connect Install the public local package with Bun, then run the MCP server from your agent host configuration. ## How it works 1. Read tasks from the project workspace. 2. Claim one task before starting. 3. Add comments when state changes. 4. Mark done only after verification. ## Core concepts - **Project** — a workspace that owns tasks, plans, and runs - **Task** — a single unit of work with status, priority, assignee, and history - **Plan** — a structured breakdown a task can attach to - **Run** — an execution attempt against a task, with logs and artifacts ## Install ``` bun install -g @hasna/todos ``` ## MCP connection ``` todos mcp ``` ## Common commands ``` todos list todos add "Write launch note" todos show todos start todos comment "Verified with bun test" todos done todos mcp ``` ## Pricing - Free: free forever up to 1,000 tasks and 10 projects - Pro: unlimited tasks and projects ## Links - Source: https://github.com/hasna/todos - Website: https://todos.md - Docs: https://todos.md/docs - Privacy: https://todos.md/privacy - Terms: https://todos.md/terms