# Overview

- html: https://gettsk.sh/docs/
- source: https://github.com/smarzban/tsk/blob/main/site/src/content/docs/docs/index.mdx
- updated: 2026-09-17T10:07:00.561Z

**tsk is a terminal task board for you and your agents: one shared queue, a TUI for you, a CLI for them.**

Use it beside your agent in Herdr, or run `tsk` in any terminal. Both use the same tasks.

## Start here

1. [Install tsk and connect Herdr](/docs/install/).
2. Your first board opens with four `N` starter tasks on the desk. Open one with `Enter`; clear it with `ctrl+d`, `ctrl+f`, or `ctrl+x` when you are done. After an upgrade, a `What's new in tsk` task arrives the same way.
3. Press `+`, type a title, and press `Enter`. It lands in the `open` inbox.
4. Pick it with `ctrl+n` when you are ready, then open the task for notes and steps.
5. Give your agent its task number.

Agents read tasks with `tsk list` and update them with `tsk status`. [Install the agent skill](/docs/cli/#setup) for the full workflow.

## Find your work

**No project setup needed.** Open tsk in your project directory and add your first task—the project appears on your board automatically. To add a task to another project, include `!p /path/to/project` in quick add, or use `-p /path/to/project` with `tsk add`.

| View | Use it for |
| --- | --- |
| **desk** | Personal tasks, plus work needing attention across projects |
| **selected project** | One project's tasks |
| **projects** | Browse projects or follow a thread across them |

| Section | Contains |
| --- | --- |
| **NEEDS YOU** | Blocked tasks and work ready for review |
| **IN MOTION** | Started tasks |
| **ON DECK** | Picked `ready` tasks, then the `open` inbox |

You or your agent set task status. Completing steps or ending an agent session does not mark a task done.

## Guides

| I want to… | Read |
| --- | --- |
| Find, filter, or archive work | [Board](/docs/board/) |
| Use keyboard shortcuts | [Keys](/docs/keys/) |
| Add a task or capture an idea | [Capture](/docs/capture/) |
| Edit notes, scope, or thread | [Task page](/docs/task-page/) |
| Break work into a checklist | [Steps](/docs/steps/) |
| Work through an agent | [Agent guide](/docs/agents/) |
| Script the board | [CLI](/docs/cli/) |
| Find data, backups, or settings | [Storage](/docs/storage/) |