New: watch your coding agents work, step by step, on a live board. Try the demo, no account

Taskhold vs Claude Code's built-in task list

By Jake Marsh, who builds Taskhold. Updated 2026-10-26. Facts about other tools checked 2026-10-26. 4 min read.

We make Taskhold. Facts about other tools come from their own sites and docs, checked 2026-10-26. Where a tool doesn't describe a feature, we say so rather than saying it lacks it. Something out of date? Email hello@greatwork.company.

Short answer: Claude Code's built-in task list is free, stored in ~/.claude/tasks/ and shows up to five tasks with Ctrl+T, but only for Claude Code on one machine. Taskhold is a hosted list at $12 a month that Claude Code, Cursor, Codex and other MCP agents share, with a live board of each task's steps you can check from a phone.

Claude Code has its own task tools. Tasks persist across context compactions, and setting CLAUDE_CODE_TASK_LIST_ID lets several sessions share one list stored under ~/.claude/tasks/. It's free and needs no setup on the models that have it. For many people that is enough, and you should use it.

Taskhold is for the cases it doesn't cover: other agents, other machines, and a person who wants to add and review tasks, and watch progress on a live board, without a terminal. If your list shows nothing at all, why the Claude Code task list is empty has the fix. Taskhold's own setup for Claude Code is one command, and agent view is compared separately.

Side by side

Side by side. Claude Code facts from code.claude.com docs (interactive mode, tools reference, agent view, mobile), checked 2026-10-26.
ItemClaude Code tasksTaskhold
PriceIncluded with Claude Code$12/month or $120/year per person, 7-day trial
Where tasks liveLocal files in ~/.claude/tasks/Hosted list, reachable from any machine
AgentsClaude CodeClaude Code, Cursor, Codex, Windsurf, any MCP client with remote server support
How you see itCtrl+T in the terminal, up to five tasks at a timeWeb app on desktop or phone, plus the Agents view
Progress while it worksPending, in progress or done per item; agent view (claude agents, research preview) shows each background session's stateLive board: a bar split by step, percent or N of M, the agent's current message, time elapsed and an estimate
When the agent needs youNeeds input state in agent view; push notifications through Remote ControlThe question sits under Needs you on the board; tap an option or type a reply, then Send and unblock, and the agent reads it with taskhold_updates
Sharing between sessionsYes, with CLAUDE_CODE_TASK_LIST_ID on one machineYes, every session and every agent you connect
HistoryNot listed in the docsEvery change kept, marked human or agent
Dependencies between tasksYesNo
ModelsOn by default for Opus 4.7, Sonnet 4.6, Haiku 4.5 and earlier; newer models need CLAUDE_CODE_ENABLE_TODO_TOOLS=1Any model, any client
SetupNone on those modelsPaste one setup URL into the agent

Claude Code facts from code.claude.com docs (interactive mode, tools reference, agent view, mobile), checked 2026-10-26.

When are Claude Code's tasks the better choice?

  • You only use Claude Code, on one machine.
  • You don't need to add or read tasks away from the terminal.
  • You want task dependencies and zero setup.

One thing to know: since Claude Code v2.1.268 the task tools are on by default only on Opus 4.7, Sonnet 4.6, Haiku 4.5 and earlier models. On newer models Claude keeps track of multi-step work without a written list, so Ctrl+T shows nothing unless you start Claude Code with CLAUDE_CODE_ENABLE_TODO_TOOLS=1. Background sessions and cloud sessions get the tools on every model.

When is Taskhold the better choice?

  • You run Claude Code next to Cursor, Codex or Windsurf and want one list for all of them.
  • You work from more than one machine, or want to queue tasks from your phone.
  • You want a record of what each task went through, with agent changes marked as agent changes.
  • You want blocked tasks, with the agent's question, collected in one place you can answer from.
  • You want to watch a long task's steps fill in from a phone or another room, whatever model you run.

Using both

Claude Code's task list and Taskhold don't conflict. Claude Code can keep its own short checklist for the steps of a task while Taskhold holds the backlog: start a Taskhold task, plan the steps with the built-in tools, complete the Taskhold task with a summary.

Moving tasks over

The importer reads them. Claude Code keeps its task list in ~/.claude/tasks/ on your machine: run cat ~/.claude/tasks/*/*.json | pbcopy and paste the result on the Import page, which keeps each task's status, description and blocked-by links. Moving Claude Code tasks into Taskhold has the details.

Share this page:XLinkedInBlueskyHacker News

Answer your coding agents from anywhere.

$12/month or $120/year after the trial. Card up front. Cancel before day 7 and you pay nothing. Every agent you run is included.

Or connect your agent first, no sign-up: add https://taskhold.com/api/mcp as an MCP server. The first time it uses Taskhold, it gives you the trial link.

Questions

Is TodoWrite the same thing?
TodoWrite was the earlier checklist tool. The docs list it as disabled by default in favor of TaskCreate, TaskGet, TaskList and TaskUpdate; setting CLAUDE_CODE_ENABLE_TASKS=0 brings it back in sessions that have the task tools.
Why is my Claude Code task list empty?
On models newer than Opus 4.7, Sonnet 4.6 and Haiku 4.5, Claude Code leaves the task tools out, so nothing is added to the list. Start Claude Code with CLAUDE_CODE_ENABLE_TODO_TOOLS=1 to get them back. The guide on the empty task list covers the other cases.
Does Taskhold replace CLAUDE.md?
No. CLAUDE.md tells the agent how to use the list; Taskhold holds the list.

Sources

Related

Updated 2026-10-26. Something wrong or out of date? Email hello@greatwork.company.