# Taskhold docs

> How to wire your coding agents, CI jobs and scripts into Taskhold, with live progress per step.

Source: https://taskhold.com/docs

## Start here

- [What Taskhold is: a task list your agents report into](https://taskhold.com/docs/overview.md): Taskhold in one page: a hosted task list you share with your coding agents, live progress per step, the MCP and REST surfaces, price, data handling.
- [Quickstart: watch your agent's first plan in 5 minutes](https://taskhold.com/docs/quickstart.md): Connect Claude Code, Cursor or any MCP client to Taskhold and watch your agent plan steps and report progress on the live board, in about five minutes.
- [Install the Taskhold CLI: terminal board and status line](https://taskhold.com/install.md): Most agents need nothing installed. One command adds the Taskhold terminal board and the Claude Code status line. How updates, pins and uninstall work.

## Live progress

- [How live progress works: steps, bars, ETA and liveness](https://taskhold.com/docs/live-progress.md): How Taskhold turns agent reports into a live board: steps as subtasks, progress rollup, the live and quiet markers, the time estimate, blocked questions.
- [How agents should write progress notes and questions](https://taskhold.com/docs/agent-messages.md): Write progress messages and blocking questions a person can act on from the live board: headline first, one request, options with a recommendation.

## Recipes

- [Show the current task in the Claude Code status line](https://taskhold.com/docs/claude-code-status-line.md): A 24-line script that puts the Taskhold task in progress, its progress bar and the running step in the Claude Code status line. Uses curl and jq.
- [Claude Code hook: start every session with your replies](https://taskhold.com/docs/claude-code-hooks.md): A SessionStart hook that tells Claude Code which Taskhold task is in progress and what you changed since, so a new session picks up your replies first.
- [Report CI and deploy progress to Taskhold with curl](https://taskhold.com/docs/ci-progress.md): Have a GitHub Actions job open a Taskhold task, plan its stages as steps, tick them off and block with the logs link on failure. Plain curl and jq.
- [Slack alerts for blocked tasks from the events stream](https://taskhold.com/docs/slack-alerts.md): A 53-line Bun script that follows the Taskhold event stream and posts to a Slack channel when an agent blocks with a question or finishes a task.
- [Review what each coding agent did this week](https://taskhold.com/docs/agent-review.md): A Bun script that reads the Taskhold events API and prints a weekly scorecard per agent, with dated evidence and the CLAUDE.md lines to add.

## Reference

- [Taskhold MCP tools reference (taskhold_*)](https://taskhold.com/docs/mcp-tools.md): Every Taskhold MCP tool: what it does, its arguments, what it returns and when an agent should call it. Remote server at taskhold.com/api/mcp.
- [Taskhold REST API: tasks, steps, progress, curl examples](https://taskhold.com/docs/rest-api.md): Taskhold REST API reference: authentication, tasks, steps, progress, notes, events and the live snapshot, with curl examples and real responses.
- [Taskhold events API and Server-Sent Events stream](https://taskhold.com/docs/events.md): Follow every Taskhold change as it happens: the cursor feed at /api/events, the SSE stream at /api/events/stream, event types and a curl watcher.
- [Troubleshooting Taskhold: errors, missing tools, no progress](https://taskhold.com/docs/troubleshooting.md): Fixes for the common Taskhold problems: no taskhold tools in the agent, 401 and 402 responses, a bar that won't move, stale cards and silent streams.
- [Glossary: blocked, steps, progress reports, setup URLs](https://taskhold.com/docs/glossary.md): What Taskhold means by blocked, step, progress report, agent label, setup URL, API key and live board, so agents, docs and people mean the same thing.
- [Security and buying questions](https://taskhold.com/docs/security.md): Where Taskhold stores data, what leaves your machine, subprocessors, auth, deletion, export, pricing and what isn't built: answers for a security review.

OpenAPI: https://taskhold.com/openapi.json
Agent setup file: https://taskhold.com/SKILL.md
Changelog: https://taskhold.com/changelog