Skip to content

Tasks and task boards

Edit task tickets and organize sibling task files on a board.

One stock plugin provides two related editors: individual tickets and a board that gathers them.

A .task file stores a single ticket as JSON with a title, description, and status.

  • Ticket is a structured form for editing those fields directly.
  • Raw exposes the underlying JSON.

If the JSON is malformed, the Ticket form asks you to repair it in Raw first, rather than guessing at broken data.

Interactive task editorA single .task ticket on the Ticket form — switch to Raw for the JSON it edits. Nothing here is saved to a tray.

A .taskboard file defines a board over the .task files that sit next to it in the same folder.

  • Board collects those sibling tickets into status columns — pending, in progress, complete, and cancelled — with anything using an unrecognized status grouped separately.
  • Raw exposes the board definition.

Dragging a card between columns changes that ticket’s status, and editing a card updates its ticket — both write straight back to the underlying .task files through Worktray’s scoped workspace access, so the board and the individual tickets never drift out of sync.

Interactive task boardA real board over sibling .task files, all in-memory — drag a card between columns or edit a ticket and it writes back to that file. Nothing here is saved to a tray.