Skip to content

Releases: smarzban/tsk

v0.10.1

Choose a tag to compare

@github-actions github-actions released this 16 Sep 11:23
e870879

Changed

  • tsk update prints 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 herdr leaves 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

Choose a tag to compare

@github-actions github-actions released this 16 Sep 00:00
8399cf8

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, then space, Shift+↑/Shift+↓, or a click marks tasks; status, archive, and delete act on the set. One ctrl+u undoes a marked done or delete.
  • / searches every board tab by title, notes, steps, thread, and task number (project names on the Projects overview). Enter pins the filter for normal keys; Esc clears 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+q quits from every non-editor surface, including task pages and the wide project preview. Esc closes 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-project refusal, search and multi-select); rerun tsk setup to 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

Choose a tag to compare

@github-actions github-actions released this 14 Sep 10:31
b709a8d

Breaking

  • Store format 4: existing ready tasks move to the new open inbox on first save. Rolling back refuses the file; restore tsk.json.v3.
  • ctrl+n now sets ready (it no longer opens Notes) and ctrl+o sets open (it no longer reopens to ready).

Added

  • open status for captured, untriaged tasks: an expandable inbox group under ON DECK, ctrl+n picks a task for ready, ctrl+o sends 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, and Esc walk 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, and tsk --version / -V.

Changed

  • tsk --help is 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: message on stderr for every task command; archive and unarchive gain 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 a Refine a task section. Skill 1.2.0; rerun tsk setup to update installed copies.
  • Task page and expanded quick-add share one Tab ring: Title, Notes, steps, + step, Thread, Scope, back to Title; Shift+Tab reverses it.
  • Task-page footer shows the thread before the project.
  • Inbox heading paints in normal text with no blank row under it.
  • ctrl+s starts open tasks as well as ready ones.
  • Board help (?) is a searchable shortcut reference: type to filter by key or action, Esc clears then closes.
  • Human tsk list output 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 in review under NEEDS YOU; the last starter guide seeds as open so a fresh board shows both ON DECK groups.
  • The Homebrew caveat also points at tsk setup agents.

Fixed

  • tsk setup agents --yes --force rewrites every detected agent skill even when the version already matches.
  • tsk setup herdr no 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

Choose a tag to compare

@github-actions github-actions released this 12 Sep 19:33
5437d2f

Breaking

  • Task store format 3, migrated automatically on first open. Rolling back to 0.7.x afterwards refuses the file; restore the tsk.json.v2 backup written beside it if you need to.

Added

  • Starter tour on first board open: four desk tasks (N1 to N4) that teach the tabs, sections, status keys, the task page, and the CLI, each cleared for good with ctrl+d, ctrl+f, or ctrl+x. Agents never see them: tsk list hides N rows.
  • What's new on your desk: after an upgrade, one N row 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 update upgrades installer-managed copies in place; Homebrew copies print brew update && brew upgrade tsk. The board nudges once a day when a newer release is out (TSK_NO_UPDATE_CHECK disables).
  • tsk setup detects the coding agents on your machine and offers to install the tsk skill for each; tsk setup agents --yes does 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: 2 opens 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 with review and leave done to you. Skill version 1.1.0; rerun tsk setup to 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, N rows 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+t opens or focuses one board per Herdr workspace, across tabs, and returns to the tab you pressed it from.
  • tsk setup herdr on 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 on herdr config check with 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

Choose a tag to compare

@github-actions github-actions released this 09 Sep 21:48
a3c6f3c

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

Added

  • tsk guide prints the agent workflow, and tsk setup <claude|pi|cursor|grok|codex|--skill-dir> installs it as a skill. tsk --help ends with a pointer for agents.
  • The installer adds ~/.local/bin to PATH for Bash and Zsh.

Fixed

  • At 110 columns or wider, Tab on 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 | sh

or 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

Choose a tag to compare

@github-actions github-actions released this 09 Sep 07:02
f5de1ce

What's new

  • Native macOS/Linux binaries, a checksum-verifying installer, and Homebrew packaging. tsk setup herdr connects 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+R toggles review, Enter toggles stored steps, and Shift+Enter saves 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

Choose a tag to compare

@smarzban smarzban released this 05 Sep 19:17
0f62cb4
  • 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 restore protect 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

Choose a tag to compare

@smarzban smarzban released this 02 Sep 21:10
  • 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

Choose a tag to compare

@smarzban smarzban released this 02 Sep 17:40

Tasks can carry an optional normalized thread.

  • Headless add accepts --thread and plan-item thread.
  • herdr-tasks list --thread <name> filters within the selected scope.
  • JSON rows always include thread.
  • Human-readable rows append #name only for threaded tasks.

v0.2.0

Choose a tag to compare

@smarzban smarzban released this 02 Sep 17:40
e334ca4

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.