Todo

A lightweight project todo list shared by humans and coding agents.

Todo keeps a compact action queue at the root of each project. Its four commands share one expression syntax for adding, finding, editing, and deleting tasks.

$ todo add Prepare for deployment +production +now
1 Prepare for deployment +now +production

$ todo edit 1 -now +done
1 Prepare for deployment +done +production

$ todo list +done -blocked
1 Prepare for deployment +done +production

Run todo help for the complete syntax and copy-ready examples.

Install

With eget:

eget dannyben/todo

Or install from source:

go install github.com/dannyben/todo@latest

Prebuilt archives for macOS and Linux are available on the repository's Releases page.

Why Todo?

• Obsessively simple. Four commands, no flags. Tasks fit on one line. Connect related tasks instead of writing stories or comment threads.
• Agent-friendly. No skill or MCP server is required. Compact, searchable output saves tokens. todo help explains every command.
• Ephemeral by design. The task list is an action queue, not a historical record. Deleted tasks leave the queue; optional backups allow manual recovery.
• SQLite by choice. The non-textual database discourages manual edits and accidental commits. Use the CLI as the shared interface.
• Your conventions. Todo defines no priorities or workflow. Choose tags such as +high, +low, +p1, +now, and +done, then teach your agent the same vocabulary.

Usage

todo add TEXT...
todo list FILTER...
todo edit ID [TEXT...]
todo del FILTER...
todo help

Adding tasks

Add tasks with plain text and optional tags

Adding tasks from a file

Add tasks in bulk from a file.

Editing tasks

Edit task text, tags, or both directly from the command line.

Editing tasks interactively

Run todo edit ID without text to edit the complete task interactively.

Listing and filtering tasks

Filter by text, ID, or tag, with AND, OR, and exclusions

Deleting tasks

Delete by ID or tag, with OR for multiple filters

Contributing / Support

For issues, questions, suggestions, or contributions, open an issue.