Taskhold vs a TODO.md file
Most people start by asking their agent to keep a TODO.md or a checklist in CLAUDE.md. That costs nothing, lives in git next to the code, and any agent can read and edit it. For one repo and one agent at a time, a TODO.md is often enough.
Side by side
| TODO.md in the repo | Taskhold | |
|---|---|---|
| Price | Free | $12/month or $120/year per person |
| Where tasks live | One file per repo, in git | One hosted list, grouped by project |
| Editing from your phone | Only through a git client | Web app in any browser |
| Two agents at once | Both edit the same file; merge conflicts and duplicate work are on you | A started task shows as in progress, so the next agent takes another |
| Who changed what | git blame, if each change is committed | Every change marked human or agent, with history |
| Blocked work | A line in the file, by convention | Blocked status with a reason, listed in Agent Activity |
| Works offline | Yes | No |
Checked 2026-10-09.
Keep the TODO.md if
- You work in one repo with one agent at a time.
- You want tasks versioned with the code and reviewed in pull requests.
- You need it free or offline.
Pick Taskhold if
- Several agents or several repos share one backlog.
- You want to add or reorder tasks from your phone while agents run.
- You want to see which tasks an agent started, blocked or finished without reading diffs of a markdown file.
Moving a TODO.md into Taskhold
Connect your agent, then ask it to read TODO.md and file each open item with taskhold_create, keeping priorities. Delete the file or leave a line pointing to Taskhold so the next session doesn't work from both.
Give your agents a list you can both see.
$12 a month or $120 a year per person, every agent included. 7-day trial with a card; cancel before it ends and nothing is charged.
Start your 7-day trialQuestions
- Can I use both?
- Yes. Some people keep a short TODO.md for the current branch and use Taskhold for the backlog across repos. Tell the agent in CLAUDE.md or AGENTS.md which one is the source of truth.
- Does Taskhold read my TODO.md automatically?
- No. Taskhold never reads your repository. An agent can copy items over with taskhold_create when you ask it to.
Related
Updated 2026-10-09