Skip to content

Overview

tsk is a task board for your terminal. Capture work, then move it through human status: ready, started, blocked, review, done.

It ships as the herdr plugin herdr-tsk. The tsk binary also runs standalone against ~/.tsk. The pane, the capture overlay, and the CLI edit the same board.

This site is the user guide. Maintainer internals live in the repo under docs/technical/.

  • Keep a queue with desk, projects, and threads
  • Capture with + on the board, or a herdr overlay
  • Open a task page for title, notes, thread, scope, and steps
  • Script the same store with tsk add, tsk list, and tsk steps

Park, resume, attention, linking, and dispatch are not in this product.

  1. Install and open the board
  2. Board for tabs, sections, and status
  3. Keys for the keymap
  4. Capture to add work
  5. Task page and steps for detail
  6. CLI when you want the board without the TUI