Overview

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.
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 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
Use keyboard shortcuts	Keys
Add a task or capture an idea	Capture
Edit notes, scope, or thread	Task page
Break work into a checklist	Steps
Work through an agent	Agent guide
Script the board	CLI
Find data, backups, or settings	Storage