Guides: working with coding agents from a task list
Guides to handing tasks to coding agents, watching their progress live, answering them when they get stuck, running several at once and reviewing their work.
Also here: setup by agent, comparisons, integrations, tools.
Start here
How to see what Claude Code is doing, liveSee what Claude Code, Codex or Cursor is doing right now: what each tool shows, what it can't, and how to get step-by-step progress on one live board.
Updated 2026-10-31. 11 min read.
Watch and answer your agents
- Answer a blocked coding agent from your phone
When Claude Code, Codex or Cursor stops with a question, answer it from your phone: the agent blocks the task on a shared board and reads your reply later.
Updated 2026-11-20. 4 min read.
- What your coding agent did while you were away
After a long agent run, check one page for what your agents finished, what is blocked on you and what they filed, instead of scrolling terminal history.
Updated 2026-10-31. 2 min read.
Hand work to agents
- How to hand tasks to your coding agent
Queue work for Claude Code, Cursor or Codex from anywhere, have the agent pick it up in priority order, and get a summary or a question back on each task.
Updated 2026-10-26. 4 min read.
- Break a spec into tasks for your coding agent
Turn a spec or PRD into a prioritized task list your coding agent works through one task at a time, with notes and a summary on each, in a list you edit.
Updated 2026-10-31. 3 min read.
- Turn TODO comments into tasks as your agent works
Have your coding agent file each TODO it leaves and each bug it spots as a task with file and line, so they reach your list instead of rotting in code.
Updated 2026-11-16. 2 min read.
- A CLAUDE.md and AGENTS.md task workflow
A short CLAUDE.md or AGENTS.md snippet that makes an agent resume work in progress, claim the next task, ask with options and finish with a summary.
Updated 2026-11-16. 9 min read.
- Move TODO.md, GitHub Issues or Linear into Taskhold
A one-time move of your backlog from TODO.md, GitHub Issues or a Linear export into Taskhold, done by your agent. Paste-ready prompts for each source.
Updated 2026-11-10. 8 min read.
- Run Claude Code or Codex overnight from a queue
Queue tasks by day and let Claude Code or Codex work through them overnight with claude -p or codex exec. Read progress and questions in the morning.
Updated 2026-10-31. 7 min read.
- How to queue a prompt in Codex CLI
Press Tab while Codex works to queue your next prompt for the following turn, or Enter to steer the turn that's running. Plus codex queue from a script.
Updated 2026-11-19. 6 min read.
Several agents and repos
- Run several coding agents in parallel on one list
Parallel Claude Code sessions in worktrees, plus Cursor and Codex, on one backlog: how agents claim tasks, how to watch them side by side, and the limits.
Updated 2026-10-31. 4 min read.
- A shared todo list for Claude Code and Cursor
Claude Code in the terminal and Cursor in the editor on one backlog: a TASKS.md both read or one list over MCP, and how they skip each other's tasks.
Updated 2026-10-31. 4 min read.
- One task list for coding agents across repos
One backlog for every repo your coding agents work in, grouped by project, so a session in any repo picks up its own tasks and you see them all at once.
Updated 2026-10-31. 2 min read.
Troubleshooting
- Claude Code task list empty? Why, and the fix
Ctrl+T shows nothing on newer Claude models because the task tools are off by default. The environment variable that brings them back, and other causes.
Updated 2026-11-19. 4 min read.
- Claude Code waits for input silently: the fix
Claude Code alerts you only in some terminals, and only when you seem away. Turn on the bell, a Notification hook or phone pushes so a prompt reaches you.
Updated 2026-10-31. 5 min read.
- Claude Code MCP server not connecting: the fix
Fixes for MCP servers that fail, wait for approval or show no tools in Claude Code: scopes, /mcp, sign-in, timeouts and debug logs, plus Taskhold checks.
Updated 2026-10-30. 6 min read.
- Claude Code subagents: see what each one is doing
Where Claude Code shows running subagents (the panel, /tasks, transcripts, hooks), what vanishes once they finish, and how to give each one a progress bar.
Updated 2026-10-30. 5 min read.
- Claude Code forgets after compaction: the fix
What survives Claude Code compaction and what doesn't, how to keep rules and the plan across it, and how to resume a task after /clear or a new session.
Updated 2026-10-30. 4 min read.
- How to find your Claude Code session ID
Find the current Claude Code session ID from a Bash command, the status line or the transcript folder, resume it from any directory, and share a session.
Updated 2026-11-19. 5 min read.
- Cursor MCP server not showing tools: the fix
Fixes for Cursor MCP servers that never connect or show no tools: mcp.json location and keys, env variables, sign-in, toggles, MCP Logs and the CLI.
Updated 2026-10-31. 6 min read.
- Codex "Waiting for startup" and MCP not loading
Codex stuck on "Waiting for startup"? The status line names the MCP server it waits on. Fixes for that, plus config.toml, trust, timeouts and env.
Updated 2026-11-11. 7 min read.
- Codex stuck on "Awaiting approval": the fix
Codex alerts only when its terminal is unfocused, and many terminals only beep. The config and hook that make approval prompts reach you.
Updated 2026-11-11. 6 min read.
- Cursor agent waits for input silently: the fix
Cursor mutes its approval sound while you're looking at that chat, and no hook fires on a wait. The settings, CLI option and stop hook that reach you.
Updated 2026-10-31. 8 min read.
- VS Code Copilot agent waiting for input: the fix
Copilot agent mode stops on Allow prompts, terminal approvals and the Continue to iterate pause. The settings that cut each stop and make it tell you.
Updated 2026-11-17. 9 min read.
- Gemini CLI waits for input silently: the fix
Gemini CLI notifications are off by default and show banners only in OSC 9 terminals. Turn them on, add a Notification hook, or use agy's own setting.
Updated 2026-10-31. 6 min read.
- Continue Claude Code after a usage limit
Claude Code can wait out a usage limit and pick the task up by itself. When it can't, resume with --continue or hand the open step to another agent.
Updated 2026-10-31. 7 min read.
- Windsurf MCP server not connecting: the fix
Windsurf is now Devin Desktop, and Devin Local replaced Cascade. Where MCP servers are read, plus fixes for ones that fail, need sign-in or show no tools.
Updated 2026-11-11. 6 min read.
- Gemini CLI MCP server not loading: the fix
Fixes for settings.json mcpServers that Gemini CLI won't load: httpUrl vs url, project vs user scope, folder trust, env variables, OAuth and /mcp list.
Updated 2026-11-11. 7 min read.
- Antigravity CLI MCP server not connecting: fix
Fixes for agy MCP servers that won't connect: mcp_config.json locations, serverUrl after Gemini CLI, Streamable HTTP only, ${VAR} in headers and /mcp.
Updated 2026-11-11. 6 min read.
- OpenCode MCP server not connecting: the fix
Fixes for OpenCode MCP servers that fail, ask for auth or show no tools: the mcp block in opencode.json, remote headers, {env:VAR}, enabled and logs.
Updated 2026-10-31. 6 min read.
- VS Code Copilot MCP tools not showing? The fixes
Fixes for MCP servers VS Code Copilot won't start or use: Copilot vs Local harness, mcp.json formats, input variables, trust, cached tools, 128-tool cap.
Updated 2026-11-19. 7 min read.
- Claude custom connector won't connect: the fix
Fixes for claude.ai and Claude Desktop custom connectors that won't connect or keep asking you to sign in: reachability, redirects, OAuth and plans.
Updated 2026-10-31. 6 min read.
Background
- Move from Todoist to Taskhold
Move your Todoist tasks into Taskhold with your API token or a project CSV. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 4 min read.
- Move from TickTick to Taskhold
Move your TickTick tasks into Taskhold with your API token or the backup CSV. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 4 min read.
- Move from Linear to Taskhold
Move your Linear tasks into Taskhold with a personal API key or a CSV export. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 4 min read.
- Move from GitHub Issues to Taskhold
Move your GitHub Issues into Taskhold with a fine-grained token or gh issue list JSON. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 4 min read.
- Move from GitLab to Taskhold
Move your GitLab tasks into Taskhold with a personal access token, gitlab.com or self-managed. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 3 min read.
- Move from Jira to Taskhold
Move your Jira tasks into Taskhold from a Jira Cloud site with an API token, or a CSV export. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 4 min read.
- Move from Asana to Taskhold
Move your Asana tasks into Taskhold with a personal access token or a CSV or JSON export. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 3 min read.
- Move from ClickUp to Taskhold
Move your ClickUp tasks into Taskhold with your API token or a CSV export. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from Notion to Taskhold
Move your Notion tasks into Taskhold from a task database with an integration token or its CSV. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 4 min read.
- Move from Trello to Taskhold
Move your Trello tasks into Taskhold from a board's JSON export. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from Google Tasks to Taskhold
Move your Google Tasks into Taskhold from the Tasks.json file in Google Takeout. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from monday.com to Taskhold
Move your monday.com tasks into Taskhold from a board exported to Excel. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 2 min read.
- Move from Microsoft Planner to Taskhold
Move your Microsoft Planner tasks into Taskhold from a plan exported to Excel. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 2 min read.
- Move from Things 3 to Taskhold
Move your Things 3 tasks into Taskhold with a read-only script that exports your to-dos. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 3 min read.
- Move from OmniFocus to Taskhold
Move your OmniFocus tasks into Taskhold from its TaskPaper or CSV export. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from Apple Reminders to Taskhold
Move your Apple Reminders tasks into Taskhold with a read-only script that exports your lists. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 3 min read.
- Move from Apple Notes checklists to Taskhold
Move your Apple Notes checklists into Taskhold by pasting a copied checklist. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 2 min read.
- Move from Claude Code tasks to Taskhold
Move your Claude Code tasks into Taskhold from the task files in ~/.claude/tasks. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from Cursor, Kiro and plan files to Taskhold
Move your Cursor, Kiro and plan files into Taskhold from plan files like tasks.md or .plan.md. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 3 min read.
- Move from Taskmaster AI to Taskhold
Move your Taskmaster AI tasks into Taskhold from its tasks.json. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from Beads to Taskhold
Move your Beads tasks into Taskhold from .beads/issues.jsonl or bd export. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 2 min read.
- Move from Backlog.md to Taskhold
Move your Backlog.md tasks into Taskhold from the task files in backlog/tasks. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from Taskwarrior to Taskhold
Move your Taskwarrior tasks into Taskhold from task export JSON. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from TODO.md and Markdown to Taskhold
Move your TODO.md and Markdown tasks into Taskhold by dropping or pasting the file. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from todo.txt to Taskhold
Move your todo.txt tasks into Taskhold by dropping or pasting your todo.txt. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from TaskPaper to Taskhold
Move your TaskPaper tasks into Taskhold by dropping or pasting the file. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from Org-mode to Taskhold
Move your Org-mode tasks into Taskhold by dropping or pasting your .org file. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from CSV, Excel and Google Sheets to Taskhold
Move your CSV, Excel and Google Sheets tasks into Taskhold from a CSV, TSV or .xlsx file. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 3 min read.
- Move from JSON to Taskhold
Move your JSON tasks into Taskhold from any JSON export or list of objects. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 3 min read.
- Move from iCalendar (VTODO) to Taskhold
Move your iCalendar (VTODO) tasks into Taskhold from an iCalendar .ics export. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 2 min read.
- Move from OPML outlines to Taskhold
Move your OPML outlines into Taskhold from an OPML outline. Preview every task first, undo in one click, re-run without duplicates.
Updated 2026-11-21. 2 min read.
- Move from TODO comments in code to Taskhold
Move your TODO comments in code into Taskhold from ripgrep output or a pasted source file. Preview everything, then undo in one click if needed.
Updated 2026-11-21. 3 min read.
- Plan in ChatGPT, hand tasks to coding agents
Plan a feature in ChatGPT, have it file tasks with steps in Taskhold, then let Claude Code, Codex or Cursor work them while you follow along from the chat.
Updated 2026-11-13. 8 min read.
- Junie MCP server not working: the fix
Junie MCP server Failed, Inactive or waiting on sign-in? Where mcp.json lives, the six statuses, Authorize, Reconnect and the millisecond timeout.
Updated 2026-11-11. 4 min read.
- Goose MCP extension not working: the fix
Goose extension failing to start or connect? config.yaml, per-session enabling, package runners, OAuth sign-in, timeouts, blocked packages, diagnostics.
Updated 2026-11-11. 5 min read.
- Warp MCP server not working: the fix
Warp MCP server not starting or its tools unused? Where Warp finds servers, auto-spawn rules, View Logs and log folders, OAuth sign-in and stale tokens.
Updated 2026-11-11. 4 min read.
- Pydantic AI agent progress and MCP tools
Watch each step of a Pydantic AI agent with agent.iter or run_stream_events, connect a remote MCP server with MCPToolset, and follow it on a live board.
Updated 2026-11-11. 4 min read.
- Vercel AI SDK agent progress and MCP tools
Track each step of a Vercel AI SDK agent with onStepEnd and isStepCount, connect a remote MCP server with createMCPClient, and put the run on a live board.
Updated 2026-11-11. 4 min read.
- OpenAI Agents SDK progress updates for long runs
Stream progress from an OpenAI Agents SDK run in Python with run_streamed, then connect an MCP server so its steps and questions reach a board you can see.
Updated 2026-11-11. 4 min read.
- MCP server not connecting? Fixes for every client
MCP server not connecting or its tools missing? The checks that fix most clients, a curl test, then the fixes for Claude, Cursor, Codex, Zed and more.
Updated 2026-11-10. 4 min read.
- Kiro MCP server not connecting: the fix
Kiro MCP server not loading or failing auth? Which mcp.json wins, Mcp Approved Env Vars, the OAuth issuer check, disabled flags and Windows launch rules.
Updated 2026-11-10. 5 min read.
- Zed MCP server not working: the fix
Zed context server not starting, or its tools missing from the agent? context_servers, the status dot, OAuth vs headers, profiles and tool permissions.
Updated 2026-11-10. 5 min read.
- Claude Desktop MCP server not showing up: the fix
Local MCP server missing from Claude Desktop? Where claude_desktop_config.json lives, the full quit it needs, the mcp logs, paths, env and Windows fixes.
Updated 2026-11-10. 5 min read.
- Import Vibe Kanban, Beads, Backlog.md, Taskmaster
Move Taskmaster, Beads, Backlog.md or Vibe Kanban tasks into Taskhold: drop the file on the Import page or use one agent prompt. Subtasks become steps.
Updated 2026-11-09. 10 min read.
- Import tasks into Taskhold from any app or file
Bring tasks into Taskhold from Todoist, Linear, GitHub, Jira, Asana, Things, Reminders, TODO.md, CSV and more. Preview first, undo in one click.
Updated 2026-11-09. 4 min read.
- MCP server token cost: how to measure and cut it
How to measure what an MCP server's tool list costs in tokens, when that cost applies, and the schema bloat you can remove without touching a description.
Updated 2026-11-05. 4 min read.
- Running dozens of coding agents on one board
Our own numbers from running Taskhold across 49 projects: 715 tasks and 2,331 steps in a week, the rule every agent follows, and what still goes wrong.
Updated 2026-11-04. 3 min read.
- CLAUDE_CODE_TASK_LIST_ID: share Claude Code tasks
How CLAUDE_CODE_TASK_LIST_ID shares one Claude Code task list across sessions, why settings.json pools every worktree, and what it can't share.
Updated 2026-11-04. 3 min read.
- Codex hooks: every event, hooks.json and examples
Every Codex CLI hook event, where hooks.json and [hooks] in config.toml go, the JSON format, what each hook returns, exit codes, trust review and examples.
Updated 2026-11-02. 6 min read.
- Cursor hooks: all events, hooks.json and examples
Every Cursor agent hook event, the hooks.json format, where the file lives, what each hook can return, exit codes, and working examples you can copy.
Updated 2026-11-01. 6 min read.
- Is it safe to connect Claude Code to a task list?
What a coding agent can and can't do with your Taskhold list over MCP, how keys work, what's stored and for how long, and how to cut an agent off.
Updated 2026-10-31. 3 min read.
- Watch Claude Code agent teams on a live board
Claude Code agent teams share a task list you only see from the lead's terminal. Give every teammate Taskhold's tools and follow the team on one board.
Updated 2026-10-31. 5 min read.
- Cline MCP server not connecting: the fix
Fixes for Cline MCP servers that won't connect or load: where cline_mcp_settings.json lives now, type streamableHttp, headers, disabled and autoApprove.
Updated 2026-10-31. 7 min read.
- Claude Agent SDK progress updates for long runs
Read progress from a Claude Agent SDK agent's messages in TypeScript or Python, then put its steps and questions on a board you can check from your phone.
Updated 2026-10-31. 12 min read.
- MCP install links for Cursor, VS Code and Claude
Add to Cursor, Install in VS Code and Add to Claude links for a remote MCP server: the exact URL formats, how the config is encoded, and README badges.
Updated 2026-10-31. 8 min read.
- AI coding statistics: adoption, trust and agents
Sourced AI coding statistics from Stack Overflow, JetBrains, DORA, METR and Anthropic: who uses AI and agents, who trusts it, and what agents write.
Updated 2026-10-31. 7 min read.
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.