Releases: smarzban/tsk
Release list
v0.10.1
Changed
tsk updateprints the version it replaces and the one it installs, re-registers an already set-up Herdr plugin without asking, and updates outdated installed agent skills (one[Y/n]ask on a terminal, unattended otherwise). It never installs a skill for an agent that had none; with nothing installed it offers the first-install ask.tsk setup herdrleaves a plugin command you bound to another key alone instead of adding the default chord beside it.
Install
curl -fsSL https://gettsk.sh/install.sh | sh or brew install smarzban/tap/tsk. Details, upgrades and uninstall: https://gettsk.sh/docs/install/
v0.10.0
Breaking
- Store format 5: one undo entry can cover a marked set. Rolling back refuses the file; restore
tsk.json.v4.
Added
- Multi-select:
Shift+M, thenspace,Shift+↑/Shift+↓, or a click marks tasks; status, archive, and delete act on the set. Onectrl+uundoes a marked done or delete. /searches every board tab by title, notes, steps, thread, and task number (project names on the Projects overview).Enterpins the filter for normal keys;Escclears it.
Changed
!p name,tsk add -p name, and JSON plan projects refuse unknown or ambiguous names (unknown-project) instead of creating a stray project. A new project needs an existing absolute path (/…or~/…).ctrl+qquits from every non-editor surface, including task pages and the wide project preview.Esccloses layers and wide splits, then quits at the full-board root on any tab. Unsaved drafts still block quitting.- Agent skill 1.3.0 (
unknown-projectrefusal, search and multi-select); reruntsk setupto update installed copies.
Install
curl -fsSL https://gettsk.sh/install.sh | sh or brew install smarzban/tap/tsk. Details, upgrades and uninstall: https://gettsk.sh/docs/install/
v0.9.0
Breaking
- Store format 4: existing
readytasks move to the newopeninbox on first save. Rolling back refuses the file; restoretsk.json.v3. ctrl+nnow sets ready (it no longer opens Notes) andctrl+osets open (it no longer reopens to ready).
Added
openstatus for captured, untriaged tasks: an expandableinboxgroup under ON DECK,ctrl+npicks a task for ready,ctrl+osends it back.tsk status T<n> open,tsk list --open,tsk list --ready.- Projects tab at 110+ columns: the cursored project previews beside the index,
→makes it a live board,←andEscwalk back. - Projects index counts ON DECK and DONE next to NEEDS YOU and IN MOTION.
tsk list T<n>prints the whole task: notes, steps, and thread, in human and JSON form.tsk help <command>as an alias for--help, andtsk --version/-V.
Changed
tsk --helpis the CLI reference: commands grouped with a Statuses block, and one 80-column skeleton per command (usage, options, examples, refusals, exit codes). Long-form detail lives in the CLI guide.- Refusals print as
code: messageon stderr for every task command;archiveandunarchivegain stable codes. - The agent skill (
tsk guide,tsk setup <agent>) is slimmed to rules of engagement, board language, the exit contract, and workflows, reads JSON by default, and gains aRefine a tasksection. Skill 1.2.0; reruntsk setupto update installed copies. - Task page and expanded quick-add share one Tab ring: Title, Notes, steps, + step, Thread, Scope, back to Title;
Shift+Tabreverses it. - Task-page footer shows the thread before the project.
- Inbox heading paints in normal text with no blank row under it.
ctrl+sstarts open tasks as well as ready ones.- Board help (
?) is a searchable shortcut reference: type to filter by key or action,Escclears then closes. - Human
tsk listoutput wraps to the terminal width, supported from 50 columns. - The starter tour mentions the projects preview and
tsk help; the upgrade notice covers this release's features. - The upgrade notice (
What's new in tsk) arrives inreviewunder NEEDS YOU; the last starter guide seeds asopenso a fresh board shows both ON DECK groups. - The Homebrew caveat also points at
tsk setup agents.
Fixed
tsk setup agents --yes --forcerewrites every detected agent skill even when the version already matches.tsk setup herdrno longer prints the plugin root on success and reports a previous registration whose root is gone before re-registering.- The selected task-page footer control is no longer dim inside its highlight.
- Expanded quick-add in a project preview keeps its draft title in the column header and styles the active notes line as an editor.
Install
curl -fsSL https://gettsk.sh/install.sh | sh or brew install smarzban/tap/tsk. Details, upgrades and uninstall: https://gettsk.sh/docs/install/
v0.8.2
Breaking
- Task store format 3, migrated automatically on first open. Rolling back to 0.7.x afterwards refuses the file; restore the
tsk.json.v2backup written beside it if you need to.
Added
- Starter tour on first board open: four desk tasks (
N1toN4) that teach the tabs, sections, status keys, the task page, and the CLI, each cleared for good withctrl+d,ctrl+f, orctrl+x. Agents never see them:tsk listhidesNrows. - What's new on your desk: after an upgrade, one
Nrow can summarise the release with a link to the changelog. This release carries none, so a 0.7.x upgrader sees only the tour. tsk updateupgrades installer-managed copies in place; Homebrew copies printbrew update && brew upgrade tsk. The board nudges once a day when a newer release is out (TSK_NO_UPDATE_CHECKdisables).tsk setupdetects the coding agents on your machine and offers to install the tsk skill for each;tsk setup agents --yesdoes it unattended. The curl installer asks the same question once when Herdr is on PATH.- Added support for OMP with
tsk setup omp, thanks @bnivanov. - Outside Git, the current directory is available as a project:
2opens its board, quick-add files there once it is open. The desk stays the default for capture and the CLI.
Changed
- The agent skill (
tsk guide,tsk setup <agent>) is rewritten around a quick-reference table and rules of engagement: agents hand work back withreviewand leavedoneto you. Skill version 1.1.0; reruntsk setupto update installed copies. - Sections hold their order while you work: NEEDS YOU, IN MOTION, DONE and the drawer's ARCHIVED group keep the most recent status change on top, and ON DECK lists its backlog oldest first,
Nrows leading. Editing a task or ticking a step no longer jumps it to the top.
Fixed
- On a wide board, clicking a task opens its details beside the board and keeps board focus; a double-click during column reflow opens the task you clicked, not a newly exposed control.
prefix+topens or focuses one board per Herdr workspace, across tabs, and returns to the tab you pressed it from.tsk setup herdron a Herdr older than 0.9 says so (herdr 0.6.8 found; tsk needs 0.9.0 or newer) and stops before touching the config, instead of failing onherdr config checkwith a usage dump.- Setup errors that quote Herdr's output keep their line breaks instead of printing a literal
\u{000a}.
Install
curl -fsSL https://gettsk.sh/install.sh | sh or brew install smarzban/tap/tsk. Details, upgrades and uninstall: https://gettsk.sh/docs/install/
v0.7.0
tsk is a terminal task board for you and your agents: one shared queue, a TUI for you, a CLI for them.
Added
tsk guideprints the agent workflow, andtsk setup <claude|pi|cursor|grok|codex|--skill-dir>installs it as a skill.tsk --helpends with a pointer for agents.- The installer adds
~/.local/binto PATH for Bash and Zsh.
Fixed
- At 110 columns or wider,
Tabon the quick-add line opened a draft page that was never painted. - A reopen request replaced by another of the same size in the same instant could be delivered as the first one.
Install
curl -fsSL https://gettsk.sh/install.sh | shor brew install smarzban/tap/tsk. Manual: download the archive for your platform and SHA256SUMS from this release, verify, then put tsk on your PATH. Linux builds are static musl (ARM64, x86-64); macOS builds need 11+ (Apple Silicon, Intel). Run tsk setup herdr to connect the binary to Herdr 0.9+. Docs: https://gettsk.sh/docs/install/
v0.6.0
What's new
- Native macOS/Linux binaries, a checksum-verifying installer, and Homebrew packaging.
tsk setup herdrconnects the same binary to Herdr with board and capture shortcuts. - Agent CLI commands to change status, edit tasks, and rename or remove steps.
- NEEDS YOU brings blocked and review tasks to the top of the board.
- Redesigned projects index with search, status counts, and persistent desk/project navigation.
- Quick capture opens the task editor in a Herdr popup. Expanded quick-add supports threads and steps.
- Clearer keyboard controls and help:
Ctrl+Rtoggles review,Entertoggles stored steps, andShift+Entersaves edits. Task deletion asks for confirmation. - Cleaner task rows: project and thread labels appear only in an open peek, leaving more room for titles.
Download the archive for your platform and verify it against SHA256SUMS before extracting tsk.
Full changelog: v0.5.0...v0.6.0
v0.5.0
- Wide task view: At 110 columns or wider, move between the full board, board plus task, task rail, and full task page without losing drafts or focus.
- Archive: Archive tasks and projects without changing human status, browse archived work, and open archived projects in read-only focus.
- Safer storage: Store format 2 adds migrations and versioned backups; bounded undo, durable trash, and
tsk trash restoreprotect deleted work. - Private local state: Unix state and configuration paths are restricted to the current user, including existing paths left by earlier releases.
- CLI and docs: New archive, unarchive, archived-list, and trash-restore commands are documented at https://gettsk.sh.
The project is available under the MIT license. Existing format 1 stores migrate in memory, then preserve tsk.json.v1 beside the live file on first save.
v0.4.0
- Task numbers: Tasks now have stable identifiers such as
T30, with CLI lookup and click-to-copy. - Desk: Projectless work now has a dedicated Desk view alongside Projects and Threads.
- Board UX: Better task editing, navigation, scrolling, text wrapping, notes rendering, and mouse controls.
v0.3.0
Tasks can carry an optional normalized thread.
- Headless add accepts
--threadand plan-itemthread. herdr-tasks list --thread <name>filters within the selected scope.- JSON rows always include
thread. - Human-readable rows append
#nameonly for threaded tasks.
v0.2.0
Per-task steps: a flat, ordered list on the task page with a shared notes and steps scroll region, step cursor, and modifier-protected add, toggle, rename, and delete verbs.
Headless commands:
herdr-tasks steps <task-id> add <text>creates a step.herdr-tasks steps <task-id> toggle <step-short-id>flips a step by unambiguous ID prefix.herdr-tasks list <task-id>prints each step with its state and short ID.
Step progress never changes the task's human status.