Billet Changelog

1.0.0

Billet's first release: a local viewer for the task files your coding agents write. It reads the billet-* skill format and shows what is open, running, and ready across projects. Billet does not create tasks, run skills, or call models.

Getting started

  • Add a folder of projects, or a single project, from the welcome, Settings, or by dropping it on the window.
  • Tasks live in each project's docs/tasks/ folder, or the Task folder chosen in Settings.
  • Billet refreshes within a second when an agent changes a file. A file it cannot read is listed with the reason and never hides the rest.
  • Until a folder has a project with tasks, the welcome shows the task format with a sample task and the skills link. An empty project says whether to run /billet-init or /billet-add.

Home

  • Home shows every project at once. Overview lists running tasks with their branch and time, stale runs, this week's starts and finishes, ready tasks, and project counts.
  • Statistics cover tasks finished per week, median time to finish, open work by hardness and area, and the oldest open tasks.
  • Timeline shows every project's dated tasks as bars from start to finish, by area, from a week to three months.
  • Click a task to open it in its project, or a project to open it.

Project views

  • List shows tasks under status headers with the selected task's read-only body beside it. A fold at the end holds recently closed tasks.
  • Kanban shows the same tasks as cards by status. Drag a card or use Shift+arrows to change its status or place, and fold columns you are not using.
  • Kanban can group by readiness: running, can start, needs a decision, and blocked.
  • Plan lays open tasks out by their blockers, each chain on its own panel. Copy the plan as one prompt of /billet-start commands, phase by phase.
  • Search (Cmd+F) finds tasks by title and body, in this project or all of them, closed tasks included.
  • Filter by area, tag, hardness, running, or can start. Sort by board order, ID, hardness, dates, or area.

The task preview

  • The preview shows the task's Markdown body, read-only and selectable, under its properties.
  • Task rows say when a task can start and how many open tasks it unblocks.
  • Connections list blockers, unblocks, links and backlinks, and other tasks that name the same files.
  • A link to another task selects it. A link to a Markdown file opens it in a reference tab. Other links are copied.

Hand-off

  • Selecting a task copies its ID and title, ready to paste into an agent.
  • Select several with Cmd+click or Shift+click, then copy them as start commands, one prompt, or the task files.
  • The task menu copies the task, start command, prompt, full file, or path, and can reveal the file.
  • Pick for Me (Cmd+R) chooses a task that can start now.

Editing and archiving

  • Billet writes only a task's header fields, and only when you ask. An agent's newer edit is never overwritten.
  • Change a task's status or place by dragging its card or with Shift+arrows. Set hardness, or clear a stale running marker.
  • Moving a task to Canceled asks for a reason first.
  • Archive a closed task from its menu, or archive every closed task finished more than 30 days ago. It keeps a task that open work still waits on or links to.
  • A quiet line at the end of Done and Recently closed offers the archive when old closed tasks are waiting.

Goals

  • A goal is an ordinary task with a folder of the same name holding its tasks.
  • The project's views show each goal once with how many of its tasks are done and running. Opening one shows only its tasks in List, Kanban, and Plan.
  • A goal is never picked or copied as one task to start.

Look and keyboard

  • The Aurora look in light and dark, with a dozen palettes.
  • Zoom, a Motion setting, European, US, or ISO dates, and a Focus mode for reading long tasks.
  • Value colors, off by default, color hardness, areas, and tags by their names, as text or pills. Each name keeps its color in every palette, and Match palette leans it toward the palette's hue.
  • Cmd+1 to Cmd+5 switch views, Cmd+P opens the project picker, the arrow keys move through every view, and ? lists every shortcut.
  • Runs on macOS, Windows, and Linux. macOS has native menus. Windows and Linux draw the same menus in a bar that hides and comes back with Alt.

Privacy and updates

  • No account, no server, nothing uploaded.
  • A deployed build asks mktwsk.xyz for the latest version number at startup and marks a newer one beside Settings. Settings turns that off.