tsk CLI
tsk is a terminal task board: a TUI for you, a CLI and two skills for agents, and task launch in its own git worktree.
- 268 ★ on the repository
- Last commit
Extended access
Why this level
- The CLI creates git worktrees, launches agents and deletes branches of merged tasks.
- The installer runs a script from an external server and changes PATH.
Install
- Works in
Manual install
curl -fsSL https://gettsk.sh/install.sh | shThe first README option for macOS and Linux; Homebrew (`brew install smarzban/tap/tsk`) and PowerShell for Windows are also given. Skills install with `tsk setup`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The CLI creates git worktrees, launches agents and deletes branches of merged tasks.
- The installer runs a script from an external server and changes PATH.
This is third-party code. Review the repository files before installing.
What it does
tsk keeps one task queue shared by a person and their agents. The person works in a terminal interface with quick capture on `+`, steps and notes, and columns for open, ready, blocked and review tasks. Agents read and change the same board through the CLI, for example `tsk add -t "title"`. `tsk setup` installs two skills: `tsk-cli` teaches an agent to read the board, add tasks and change statuses, while `tsk-coordinator` lets it brief builders and review their pull requests. `ctrl+s` launches an assigned task: tsk creates a git worktree and a workspace in Herdr or Rex, then offers cleanup on completion without touching uncommitted changes.
Who it is for. Developers running several agents in parallel who want a shared task queue beside the terminal instead of in a browser.
Good fit when
- A thought or bug must be captured quickly with `+` and the task number passed to an agent later.
- An agent takes a task, writes steps and moves it to review through `tsk-cli`.
- Several tasks run in separate worktrees, each with its own Herdr or Rex tab.
- A coordinator briefs builders itself and reviews their pull requests, reporting on the board.
Not a fit when
- A team board with shared access and notifications is needed: tsk works locally in a terminal.
- Agents must be launched outside Herdr and Rex: dispatch exists only inside them, and on Windows it is a preview.
- A browser task manager with charts is needed: the interface is terminal-only.
Example request
Add a task "fix the login timeout" with reproduction steps, assign it to a builder agent and launch it in a separate worktree.Limitations
Launching tasks in a separate worktree works in Herdr and Rex, and on Windows that part is still a preview. The default installation uses the script `curl -fsSL https://gettsk.sh/install.sh | sh`, which runs code from an external server, with Homebrew as an alternative. Agents are described in `config.toml`. Cleanup after completion deletes a branch only for a merged task. The repository changes actively, and the latest commit is dated November 2026.
How to disable. Run the uninstall steps from the guide at `gettsk.sh/docs/install/`, then delete the `tsk-cli` and `tsk-coordinator` skill folders from the agent directories. Configuration lives in `config.toml` and board data is stored locally.
FAQ
How do I install tsk?
On macOS and Linux run `curl -fsSL https://gettsk.sh/install.sh | sh` or `brew install smarzban/tap/tsk`. On Windows use the PowerShell installer from the README.
Which agents are supported for skills?
`tsk setup` finds agents itself and asks once. You can name one: `tsk setup claude`, `cursor`, `codex`, `opencode`, `grok`, `pi` or `omp`.
What do the tsk-cli and tsk-coordinator skills do?
`tsk-cli` teaches an agent to read the board, add tasks and update statuses and steps. `tsk-coordinator` lets it assign tasks to builders, review their pull requests and report on the board.
Are Herdr or Rex required?
Not for the board itself: `tsk` runs in any terminal. They are needed for automatic task launch in tabs and worktrees.
What does ctrl+d do on a running task?
It marks the task done and offers a cleanup card: the tab or workspace closes, the worktree is removed and the branch is deleted only after merging.
Discussion
No questions or reviews yet.
Related
CLI toolsA terminal kanban board in Python that Claude Code and other agents can read and change through a CLI or MCP
Official Todoist command line with an agent skill: tasks, projects and inbox from the terminal
tasks-axi gives an agent short commands for a Markdown backlog: add, start, finish, block and find ready work
A small issue tracker for AI agents: tasks, epics and dependencies live in a project SQLite file, with a local board.
kanban-md runs a file-based task board for agents and people: Markdown tasks, expiring claims and a terminal UI
kata is a local issue tracker for coding agents: the agent creates, claims and closes issues with evidence, humans watch in a TUI
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| tsk (this card) | no | 268 | ||
| Agent Kanban | no | 502 | A kanban board for agents; tsk runs in the terminal, launches tasks in worktrees and installs two skills | |
| kanban-tui | no | not required | 289 | A terminal kanban for people; tsk adds a CLI and skills so agents run the same board |
README in short
The repository describes a terminal task board: quick capture, steps, statuses, assignment to agents and launch in separate worktrees. The README lists keys and installation for macOS, Linux and Windows. MIT license, with detailed guides on the project site.