$ tsk · a task board in your terminal · herdr plugin, runs standalone
One board where you both plan, pick up work, and move it through open, ready, started, blocked, review, done. You and your agents can create, edit, and complete tasks.
$ curl -fsSL https://gettsk.sh/install.sh | sh
T-number you can click to copy, and the wrapped title. Project or thread attribution appears only at the bottom of an open peek.
Peek. Below 110 columns, →, l, or a click shows up to five wrapped note lines under the task. Wide, those keys or a click open the task page beside the board instead. ← or h closes it; Enter opens the full page.
Your loose backlog. Desk's ON DECK contains only tasks without a project. Picked ready tasks lead, then the expandable inbox of open tasks. Project backlogs live on their own boards, with thread filters across every status.
tsk is the shared surface between a developer and the agents working beside them. It lives in the pane you already have open. No browser tab, no sync service, no form takeover.
+ opens one line on the status row. Enter saves, Shift+Enter keeps the line open, Tab expands onto the task page. Two tokens set project and thread from inside the title.
+ Fix the flaky bench !p tsk !t ci enter save · shift+enter stay · tab page · esc close
Every mutating verb needs Ctrl. Bare letters do nothing, so a stray keystroke in a focused board cannot finish or delete work. Undo is one chord away.
enter open · ctrl+d done · ctrl+n ready · ctrl+o open · : palette ctrl+x delete · ctrl+u undo · ? help · + capture
You, herdr's quick-capture popup, and your agents edit the same
~/.tsk. An agent drops a plan in as JSON, new tasks enter the inbox, and the board shows them on
the next tick.
$ cat plan.json | tsk add { "created": [T33, T34, T35], "existing": [], "failed": [] } $ herdr plugin action invoke quick-capture --plugin herdr-tsk
Double-click a task to open it, check off a step, or press + to add your own. Switch to Projects at a wide width, then move to a project to preview its board. Explore auth, API, and reliability work with threads and checklists. Press Shift+M to mark several tasks and act on them at once. Changes stay in this demo; refresh to start over.
Two real layouts. Beside an agent, tsk is the 78-column board herdr opens by default, and → or l peeks. Give it the whole terminal, or drag the divider past 110 columns, and the same board becomes the four-stage slider: → or l slides the task page in. On the Projects tab, moving to a project opens its preview at Split, and → or l makes that project board live at Rail. The demo takes bare s n o d b because browsers keep the control chords. In the app, every mutating verb needs Ctrl. Esc closes either split after its editors and overlays. At the full-board root, Esc exits the terminal app; here it only releases keyboard focus, keeping the current tab. This demo covers marking and updating task sets, browsing, opening tasks, plus adding, checking, renaming and removing steps. Full task editing and save recovery remain unfinished.
Inside Git, start on the repo’s project board. Outside Git, start on desk with the current directory one tab away. desk shows what needs you across projects, active work, and your loose backlog. The selected project stays one key away; projects is a searchable index with a View selector for cross-project threads. Filter threads within a project with t, or across projects with v on the index. Give the board 110 columns and it becomes a slider.
At 110 columns and up, focus and geometry are the same thing. One rule, one footer, no colour.
→ / l one stage right ← / h one stage left Enter jump to the page and remember where you were Esc go back there
Six states shared by everyone on the board. You and your agents can create tasks, edit titles and notes, manage steps, and move tasks through the board, from open to done, using the CLI. Checking every step leaves the task status unchanged until it is explicitly updated.
Headless add, list, status, edit, and steps against the
same store. An agent drops a plan in as JSON and it lands as open tasks in the inbox. It
can move status, rewrite notes, check off steps, and mark work done.
$ tsk add -t "Draft release notes" -p tsk --thread release --json {"outcome":"created","id":"5c1e…","number":32,"title":"Draft release notes","project":"tsk"} $ tsk steps T32 add "Write the failing test" added 9f Write the failing test $ tsk status T32 start status T32 started Draft release notes $ tsk list T32 STARTED - 32 Draft release notes #release [ ] 9f Write the failing test $ cat plan.json | tsk add { "created": [...], "existing": [...], "failed": [] }
Use tsk for my task board. Run `tsk guide` and follow it; if tsk is not installed, read https://gettsk.sh/docs/agents.md and ask me before installing.
Everything an agent needs is one command or one URL. Every docs page is
also Markdown: /docs/cli/ is /docs/cli.md.
| 0 | listed, created, existed, or applied |
|---|---|
| 1 | one or more item refusals. Retry the failed subset. |
| 2 | usage or parse error. Nothing persisted. |
| 3 | store I/O. Indeterminate. tsk list before retrying. |
tsk setup grok
https://gettsk.sh/docs/cli.md
Adds are idempotent on title, project, and thread. --json is flat
and stable. CLI reference →
One binary, standalone or in Herdr. State lives in ~/.tsk on macOS/Linux or
%LOCALAPPDATA%\tsk on Windows, whether you run it bare or inside Herdr.
$ curl -fsSL https://gettsk.sh/install.sh | sh
Or install with Homebrew:
$ brew install smarzban/tap/tsk
Windows 10/11 ARM64 or x86-64:
PS> irm https://www.gettsk.sh/install.ps1 | iex
If prompted on macOS or Linux, reopen your terminal or run the installer's printed export command.
When Herdr is already installed, an interactive install may ask to run tsk setup herdr;
when agent skill roots are detected it also asks once to install the tsk skill.
The wrap-up then points at the board (prefix+t after Herdr setup, or tsk setup herdr / tsk setup when those asks are skipped).
Open the board with tsk. Add a task with tsk add -t "your task title".
Installation details.
$ tsk setup herdr $ herdr server reload-config
After installing, connect the same binary to Herdr (the curl installer may offer this when Herdr is already present). Press prefix+t to open or focus
this workspace's board across tabs, or prefix+a to add a task. Other workspaces keep their boards. Setup asks before replacing conflicting shortcuts.
Coming soon
The next phase brings agent execution into the board: assign a task to an agent, start implementation from tsk, and run the work in Herdr worktrees.
Choose who takes on the task, with its notes and steps as the brief.
Initiate implementation where you already plan and track the work.
Give the implementation its own worktree alongside your other work.
Planned for the next phase. Not available in the current build.