smarzban/tsk

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

Keep the next task, the work in progress, and the things waiting on you in view. Press + to capture a thought, add notes and steps when it needs a plan, and give your agent the task number when you're ready to work on it. New tasks start in the open inbox; pick the next one when you're ready.

In Herdr, prefix+t opens or focuses your workspace's board, even across tabs; other workspaces keep their own views of the same tasks. prefix+a opens quick capture. Click a task's T number to copy it, then paste it into your agent conversation.

In a wide pane, click a task or press → / l to open its details beside the board; ← / h brings you back. Press Enter for a full-screen task and Esc to return. For a standalone board, run tsk in your terminal.

From task to implementation. 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.

macOS and Linux (ARM64 or x86-64):

curl -fsSL https://gettsk.sh/install.sh | sh

Or install with Homebrew:

brew install smarzban/tap/tsk

Windows 10/11 on ARM64 or x86-64, in a PowerShell window:

irm https://www.gettsk.sh/install.ps1 | iex

The installers add tsk to your PATH and, when Herdr or coding agents are detected, offer to set them up. If prompted, reopen your terminal. Options, upgrades, and uninstall are in the install guide.

Install Herdr if you haven't already, then:

tsk setup herdr
herdr server reload-config

Install the tsk skill so your agent knows how to read the board, add tasks, and update their status and steps:

tsk setup

On a TTY that detects agents once and asks to install. Or name one agent (pi, omp, claude, cursor, grok, codex, or opencode) to install into its user-level skills directory. Other skill directories and setup options.

Run tsk, or press prefix+t in Herdr.

No project setup needed. Inside Git, tsk opens the repository project. Outside Git, it opens your desk and keeps the current directory ready on the project tab.

tsk add -t "your task title"

Or press prefix+a in Herdr, or ask your agent to add a task to the board.

For example: “Add a task to the board to fix the login timeout, with steps to reproduce the bug.”

Installation details and upgrades.

Mouse or keyboard, your choice. Click tabs to switch views, double-click a task to open it, and scroll through your board. The actions along the bottom are clickable too, including adding a task and changing its status. Shift+M marks several tasks so one action covers them all.

Prefer the keyboard? A few keys for everyday use:

Full keymap · Board guide · CLI reference

See the user guide for installation, task management, agent setup, and the full CLI reference.

See CONTRIBUTING.md for development and pull-request guidance. Report vulnerabilities privately as described in SECURITY.md.

MIT