Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 24 additions & 22 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,39 +12,41 @@ first added in the same Unreleased section is not an entry: edit that entry inst

## Unreleased

## v0.14.0

### Breaking

- Dispatch refusal codes name no host: `not-in-herdr` is `no-host` and `herdr-failed` is `host-failed` ([refusal codes](https://gettsk.sh/docs/cli/#exit-contract)).
- Store format 7 records each dispatch's host, project titles, and due days: `tsk list T12 --json` shows `host` and `session`, and Herdr keeps `herdr_workspace_id`. tsk 0.13 and older refuse it; roll back with `tsk.json.v6`.
- tsk 0.14 updates your task file on its first save, and tsk 0.13 or older cannot open it afterwards. To go back, restore the `tsk.json.v6` copy beside it.
- Two dispatch refusal codes are renamed: `not-in-herdr` is now `no-host`, and `herdr-failed` is now `host-failed` ([refusal codes](https://gettsk.sh/docs/cli/#exit-contract)).
- A backup URL with a user name, such as `https://org@host/…`, skips your credential manager. Remove `org@` from the URL so it logs you in ([credentials](https://gettsk.sh/docs/storage/#credentials)).

### Added

- Rex support: `tsk setup rex` binds the board to `alt+t` and quick capture to `alt+a`. The installer and `tsk update` offer or refresh it ([Add to Rex](https://gettsk.sh/docs/install/#add-to-rex)).
- Dispatch in Rex: each task gets its own tab in the Rex session you dispatch from; relaunch, reply delivery, cleanup, and `--merge` work as in Herdr ([dispatch](https://gettsk.sh/docs/dispatch/)).
- A task dispatched in Herdr or Rex starts plainly in the other; relaunch, reply delivery, and cleanup there refuse with `other-host`.
- `[dispatch] worktrees` in `config.toml` sets where dispatch puts new worktrees ([worktree location](https://gettsk.sh/docs/storage/#worktree-location)).
- Step progress: started, blocked, and review tasks show `steps 2/5` in their board row and in `tsk list`; `--json` rows carry `steps_done` and `steps_total` ([rows](https://gettsk.sh/docs/board/#rows)). Thanks @joops (#273).
- Project titles: `ctrl+e` on a project row or `tsk project title` names a project; `-p` accepts the title ([project titles](https://gettsk.sh/docs/board/#project-titles)). Thanks @s3rgiosan (#249).
- `tsk checks T12 set 2 passed` marks a review check from the command line ([checks](https://gettsk.sh/docs/cli/#checks)). Thanks @Tobi4161 (#269).
- Due days: `tsk add --due YYYY-MM-DD`, `tsk edit --due` or `--clear-due`, a plan item's `due`, `tsk list --sort due`, quick-add `!d`, and the task page's Due field. Thanks @bnivanov-true (#270).
- Rex: `tsk setup rex` puts the board on `alt+t` and quick capture on `alt+a`. The installer and `tsk update` offer it ([Add to Rex](https://gettsk.sh/docs/install/#add-to-rex)).
- Dispatch works in Rex: each task opens in its own tab in your Rex session. Relaunch, replies, cleanup, and `--merge` work as in Herdr ([dispatch](https://gettsk.sh/docs/dispatch/)).
- A task dispatched in Herdr starts as a plain status change in Rex, and the other way round. Relaunch, replies, and cleanup there refuse with `other-host`.
- Due days: `!d 2026-11-30` in quick add, the Due field on the task page, or `tsk add --due`. `tsk list --sort due` lists the nearest first. Thanks @bnivanov-true (#271).
- Step progress: started, blocked, and review rows show `steps 2/5` on the board and in `tsk list` ([rows](https://gettsk.sh/docs/board/#rows)). Thanks @joops for the request (#273).
- Project titles: name a project with `ctrl+e` on its row or `tsk project title`, and use the name with `-p` ([project titles](https://gettsk.sh/docs/board/#project-titles)). Thanks @LukasGold for the request and @s3rgiosan for the report (#249).
- `tsk checks T12 set 2 passed` marks a review check from the command line ([checks](https://gettsk.sh/docs/cli/#checks)). Thanks @Tobi4161 for the request (#269).
- `[dispatch] worktrees` in `config.toml` chooses where new worktrees go ([worktree location](https://gettsk.sh/docs/storage/#worktree-location)).
- `tsk list T12 --json` shows where a dispatch runs as `host` and `session`. Herdr dispatches also keep `herdr_workspace_id`.

### Changed

- Agent skills 1.7.0 cover dispatch in Herdr and Rex; the coordinator hands a passed review to you and cleans up after every merge. `tsk update` refreshes installed copies.
- Dispatch puts new worktrees under `~/.tsk/worktrees/<repo>/` instead of Herdr's `~/.herdr/worktrees`. Tasks already dispatched keep their worktree.
- Dispatch messages name Herdr or Rex: outside both, a start prints `no launch: outside Herdr or Rex`.
- `tsk setup` names both installed skills, `tsk-cli` and `tsk-coordinator`, beside each agent's skills directory instead of printing only the `tsk-cli` file.
- A backup URL with a user name, such as `https://org@host/…`, no longer asks your credential manager. Drop `org@` from the URL ([credentials](https://gettsk.sh/docs/storage/#credentials)).
- New worktrees go under `~/.tsk/worktrees/<repo>/`. Tasks already dispatched keep theirs.
- Dispatch messages name Herdr or Rex. Outside both, a start prints `no launch: outside Herdr or Rex`.
- Agent skills 1.7.0 cover dispatch in Herdr and Rex. The coordinator hands passed reviews to you and cleans up after each merge. `tsk update` refreshes them.
- `tsk setup` lists both installed skills, `tsk-cli` and `tsk-coordinator`, for each agent.

### Fixed

- `ctrl+l` redraws the whole board and turns clicks back on after a terminal hid and reopened its pane ([keys](https://gettsk.sh/docs/keys/#esc-and-quit)).
- The starter tour and the site footer link to https://x.com/smarzban. A tour already on your board keeps its notes.
- `tsk list -p` and `tsk project archive|unarchive` refuse a name two projects share, like `tsk add`, instead of matching nothing. Thanks @s3rgiosan (#249).
- `tsk list --all --group project` labels projects that share a name by their shortest distinct path, such as `site-a/wordpress/wp-content`. Thanks @s3rgiosan (#249).
- A bare token in an https backup URL is removed and masked even when the URL does not start at the scheme.
- An open board shows the update notice as soon as the release check finishes, and a board left open checks again once a day.
- A token in a backup URL stays out of git's command line and the backup's local clone, so other local users cannot see it.
- `ctrl+l` redraws the whole board and turns mouse clicks back on after the terminal hid the pane ([keys](https://gettsk.sh/docs/keys/#esc-and-quit)).
- Two projects with the same folder name: `tsk list -p` and `tsk project archive|unarchive` refuse the name instead of matching nothing. Thanks @s3rgiosan for the report (#249).
- `tsk list --all --group project` tells same-named projects apart by path, such as `site-a/wordpress/wp-content`. Thanks @s3rgiosan for the report (#249).
- A token in a backup URL stays out of git's command line and the local clone, and is always masked in output.
- An open board shows the update notice as soon as the check finishes, and checks again daily.
- The Windows installer works on machines where `Expand-Archive` fails.

## v0.13.0

Expand Down
2 changes: 1 addition & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "tsk-tui"
version = "0.13.0"
version = "0.14.0"
edition = "2021"
description = "tsk: a task board for your terminal"
license = "MIT"
Expand Down
9 changes: 7 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@

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

| Runs in | Open the board | Quick capture | Dispatch agents |
| --- | --- | --- | --- |
| [Herdr](https://herdr.dev) | `prefix+t` | `prefix+a` | ✓ |
| [Rex](https://www.superlogical.com/rex/) | `alt+t` | `alt+a` | ✓ |
| Any terminal: T3 Code, Cursor, VS Code, Ghostty, iTerm2 | `tsk` | `tsk capture` | — |

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 are ready. New tasks start in the open inbox.
Expand All @@ -24,8 +30,7 @@ Click a task's `T` number to copy it, then paste it into your agent conversation
![A wide tsk board with the selected task's notes and steps open alongside it](docs/images/wide-task-page.png)

In a wide pane, click a task or press `→` or `l` to open it beside the board; `←` or `h`
brings you back. `Enter` opens the task full screen and `Esc` returns. Outside Herdr
or Rex, run `tsk` in any terminal.
brings you back. `Enter` opens the task full screen and `Esc` returns.

### From task to implementation

Expand Down
2 changes: 1 addition & 1 deletion herdr-plugin.toml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

id = "herdr-tsk"
name = "herdr-tsk"
version = "0.13.0"
version = "0.14.0"
description = "Queue board and quick capture inside herdr."
min_herdr_version = "0.9.0"
platforms = ["linux", "macos", "windows"]
Expand Down
2 changes: 1 addition & 1 deletion site/src/version.mjs
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
// Crate and plugin version, shown in the landing and docs headers.
export const VERSION = '0.13.0';
export const VERSION = '0.14.0';
4 changes: 2 additions & 2 deletions src/announcements/catalog.toml
Original file line number Diff line number Diff line change
Expand Up @@ -30,5 +30,5 @@ notes = "Define your agents in config.toml (the starter file has examples), then

[[announcement]]
id = 7
title = "tsk runs in Rex"
notes = "Run tsk setup rex to bind the board to alt+t and quick capture to alt+a in Rex. The installer and tsk update offer it when Rex is installed.\n\nDispatch works in Rex too: ctrl+s on an assigned project task opens a tab named after the task, such as t12-claude, in your Rex session and launches the agent there. Relaunch, replies, cleanup, and merge work as in Herdr.\n\nNew worktrees go in the worktrees folder beside your tasks (~/.tsk/worktrees on macOS and Linux), or wherever [dispatch] worktrees in config.toml points. Tasks already dispatched keep theirs.\n\nGive a project a title: ctrl+e on a project in the picker or the Projects view, or tsk project title. The title shows wherever the board names the project, and -p accepts it.\n\nChangelog: https://github.com/smarzban/tsk/blob/main/CHANGELOG.md"
title = "Rex, due days, and project titles"
notes = "Run tsk setup rex to bind the board to alt+t and quick capture to alt+a in Rex. The installer and tsk update offer it when Rex is installed.\n\nDispatch works in Rex too: ctrl+s on an assigned project task opens a tab named after the task, such as t12-claude, in your Rex session and launches the agent there. Relaunch, replies, cleanup, and merge work as in Herdr.\n\nNew worktrees go in the worktrees folder beside your tasks (~/.tsk/worktrees on macOS and Linux), or wherever [dispatch] worktrees in config.toml points. Tasks already dispatched keep theirs.\n\nGive a project a title: ctrl+e on a project in the picker or the Projects view, or tsk project title. The title shows wherever the board names the project, and -p accepts it.\n\nA task can carry a due day: !d 2026-11-30 in quick add, the Due field on the task page, or tsk add --due. tsk list --sort due puts the nearest first.\n\nStarted, blocked, and review rows show how many steps are done, such as steps 2/5. tsk checks T12 set 2 passed marks a review check from the command line. Rerun tsk setup to update your agent skills.\n\nChangelog: https://github.com/smarzban/tsk/blob/main/CHANGELOG.md"
8 changes: 5 additions & 3 deletions src/guides.rs
Original file line number Diff line number Diff line change
Expand Up @@ -51,9 +51,10 @@ pub const CATALOG: [Guide; 4] = [
**Make one**\n\
- Press `+`, type a title, press `Enter`. It lands in the ON DECK inbox as `open`.\n\
- Press `ctrl+n` when you pick it for the ready queue.\n\
- Press `Tab` instead of `Enter` to open the full page first, where you can add notes, steps, a thread, and a project before you save.\n\
- Type `!p name` in the title to file it under a project the board already knows, by its folder name. A full path to an existing folder, like `!p ~/code/widget`, adds a new one. Bare `!p` keeps it on your desk.\n\
- Press `Tab` instead of `Enter` to open the full page first, where you can add notes, steps, a thread, a project, and a due day before you save.\n\
- Type `!p name` in the title to file it under a project the board already knows, by its title or folder name. A full path to an existing folder, like `!p ~/code/widget`, adds a new one. Bare `!p` keeps it on your desk.\n\
- Type `!t release` in the title to tag it with the thread `release`. Threads group related work inside one project, and the project board can filter by them.\n\
- Type `!d 2026-11-30` in the title to give it a due day.\n\
\n\
**Read one**\n\
- `→` peeks at the notes under the task. `←` or `Esc` closes the peek.\n\
Expand All @@ -63,7 +64,8 @@ pub const CATALOG: [Guide; 4] = [
**Change one**\n\
- On the page, `ctrl+e` edits the title, then `Tab` moves to notes. `shift+Enter` saves.\n\
- `Enter` on a step checks it. The `+ step` row at the bottom adds one.\n\
- Steps never finish a task. Check every step below and this task stays `started` until you press `ctrl+d`. You decide when work is done.",
- Steps never finish a task. Check every step below and this task stays `started` until you press `ctrl+d`. You decide when work is done.\n\
- While a task is started, blocked, or in review, its row shows how many steps are done, such as `steps 1/4`.",
status: HumanStatus::Started,
steps: &[
("Press Enter on this step to check it", false),
Expand Down
Loading