[smarzban]

Final docs pass before #120. Every page was diffed against the code, and the features merged since the docs cleanup (T304–T316) were checked. Each one has one owner page, and its keys and flags are listed. Docs-only change, plus the skill hash pin.

Words before → after

File	Before → after
CHANGELOG.md	3382 → 3391
README.md	761 → 778
packaging/README.md	2528 → 2559
site/public/llms.txt	598 → 600
board.md	3942 → 3976
capture.md	748 → 787
cli.md	6262 → 6268
index.mdx	453 → 464
keys.md	2858 → 2862
storage.md	2889 → 2906
task-page.md	2312 → 2336
index.astro	3168 → 3172
skills/tsk-cli/SKILL.md	2084 → 2107 (version stays 1.6.0, FNV pin refreshed)
catalog.toml (What's new 6)	673 → 686

CHANGELOG (Unreleased)

• Added: one line for the live lines under blocked and review rows, z, ✉, and [board] messages (T305). These had no entry before.
• The waiting-on entry names w (T309). The After entry stays as it was; picker detail lives in board.md.
• Removed Fixed "tsk restore of an older version keeps task numbering". tsk restore is first added in this same Unreleased section, so the fix is not an entry.
• No entries for the T314 credential redaction or the T315 launcher. Both refine backup and dispatch, which are added in this section.
• Every line is 30 words or fewer (word-counted; the longest is 30). The shipped sections are untouched.

What's new id 6

• Adds "z hides agent messages under rows" and "tsk restore brings a version back".
• Every key it names was checked in code: @, ctrl+s, ctrl+d, m on the cleanup card, ctrl+b, ctrl+r, r, Enter on a check, z, !w, ctrl+u.

Moved facts

• cli.md: the line saying credentials print as *** moved from the restore bullets to the backup intro. It covers both verbs and links to storage.md#credentials, which owns the fact.

Corrected claims

File	Old claim	Code
storage.md Files	launchers\, cleanups\ are "Windows only" (cleanups/ row: an interrupted removal makes the next cleanup refuse with how to finish by hand, src/dispatch.rs:2295-2311,2572-2591)	Both are written on every platform since T315: src/agents.rs:484-491, src/dispatch.rs:952-970. Launchers delete themselves: src/agents.rs:487-491,569-571
capture.md (F-32/F-35)	herdr plugin action invoke quick-capture on every platform	On Windows the action is quick-capture-windows: herdr-plugin.toml [[actions]], src/setup.rs:24,29. Now a per-platform table
capture.md	tsk capture takes no --state-dir (not mentioned)	T316: tsk capture --state-dir (links to cli.md)
packaging/README.md (F-29)	The update rehearsal set only HOME, XDG_CONFIG_HOME, and HERDR_SOCKET_PATH	Now also TSK_STATE_DIR, HERDR_CONFIG_PATH (checked first by src/setup.rs config_path()), and XDG_STATE_HOME, plus a sentence naming every root (AGENTS.md "Isolated state")
cli.md restore	The list column is "host"	The column is machine: src/cli/backup.rs version_table
cli.md trash	"Restores a deleted task with its number."	Or the next free number: src/cli/trash.rs:15, src/cli/presenter.rs:2311-2328
llms.txt	The list of commands that are not idempotent left out tsk reply	src/cli/presenter.rs:1927-1933, skill rule 3
board.md Rows	The live line shows "their newest reply"	Only a reply that is newer than yours
board.md peek	Lists only after	Also before T205
board.md Multi-select	The set verbs leave out "waiting on"	The palette's set waiting on… acts on the marked set (T232)
board.md Task picker	Title T5 runs after. Pinned rows unmarked	T12 runs after or 3 tasks run after. Pinned rows marked ✓. Done and archived tasks are not offered
task-page.md footer	Unset base is always ⎇ main (default). after shows only when set. Action bar only in view mode	⎇ default on the desk. after also shows during an edit. Edit mode with no field open (src/ui/board/draw.rs:831-851, pinned by tests/queue_board_render.rs:4201) is shift+enter save · ctrl+a add step · esc cancel · : commands. Examples use canonical numbers
keys.md	z "hide / show the live lines"	The help and palette name it "hide / show agent messages" (src/ui/input.rs:796-801). The row now uses that label
keys.md	Group, sort, assignee, and base pickers: Tab selects	shift+Tab selects too (src/ui/input.rs:2809-2810, src/ui/board/apply.rs:2401-2403)
index.astro "Verb bar"	The footer ends ? help	Since T310 it ends : commands · ? help
README / index.mdx	One skill	tsk setup installs tsk-cli and tsk-coordinator. The overview links the Coordinator page
SKILL.md	Not mentioned	New rule 12: tsk trash restore may give the task a new number, so use the one it prints (T316)

Checked and already correct: dispatch.md, install.md, steps.md, the rest of storage.md ([board] messages/me, credentials, store v6 and tsk.json.v5), the new keys in keys.md (z, w, ctrl+x/ctrl+u in the assignee picker, After picker keys, :), and the demo (: commands and ✉ already shown, so no demo edit and no parity run).

Help text fixed (were suspected bugs)

• tsk --help edit line: change title, notes, assignee, base, after list, or who it waits on (was: no --on).
• tsk --help backup line: back the store up to one or more git repositories (was: "a git repository"). No golden or test pins either line.

Left as is

• Landing pillar "Three ways in" shows herdr plugin action invoke quick-capture, the macOS/Linux action id. It stays because it is a $ shell sample. capture.md owns the per-platform form.

Checks

• cargo fmt --check && cargo clippy --all-targets -- -D warnings && cargo test: green, including docs_parity:: and cli_discovery::.
• cargo clippy --all-targets --target x86_64-pc-windows-gnu -- -D warnings: green.
• cd site && npm run build && npm test: 57/57.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
herdr-tsk	Ready	Preview	Oct 21, 2026 6:29am UTC