Skip to content

The board

The board holds your tickets in five fixed columns. Drag a ticket between columns to change its status; open one to edit its details or read its activity.

A move alone does not start a Session. One case does: when a deliberate move brings a ticket into a column with an enabled, armed Automation, that Automation can start a fresh Ticket Session.

Home Board with five task columns, ticket cards, filters, and the search field above the board.

  • Backlog holds work you have recorded but are not ready to schedule.
  • Todo holds work you plan to do next.
  • Doing marks active work.
  • Needs Review marks work ready for inspection.
  • Done marks finished work. A ticket remains on the board until you archive it.

Use the view control beside the ticket count to switch between Board view and List view. Board view shows cards in columns; List view shows tickets as rows, grouped by column. Switching views keeps the current filters and sort order.

Use Priority in the board header, or Labels when the project has labels, to narrow the visible tickets. Each filter accepts multiple values and matches any selected value. Select Clear to reset active filters.

Choose Manual, Priority, Created, Updated, or Title to sort tickets within each column. Manual keeps the order you set by dragging. Other fields let you sort ascending or descending. Sorting by a field does not change the saved manual order.

Use the command palette (⌘K) to search tickets and Sessions across projects.

Drag a card to another column, or choose Move to from its context menu. In a Ticket view, changing Status beside the title in the Ticket Body tab also moves it. The volli ticket move command makes the same move from a terminal.

A deliberate move records the destination you chose, whoever made it: you or a Ticket Session using volli ticket move. A Session’s completion or blocked signal records its outcome; it does not change the ticket’s status.

Moving from Doing or Needs Review to Backlog, Todo, or Done interrupts the ticket’s live Sessions. Moving between Doing and Needs Review does not.

Volli keeps the status chosen by a deliberate move; a Session ending does not move the ticket to another column.

The bolt in a column header chooses which offered Automation can start when a ticket enters that column. A column can offer several Automations but arm only one. You can always start a Run by hand, even when automatic triggers are off. See Arm a column Automation for enablement on your machine, column arming, and Option-drag choices.

Right-click a ticket to open its context menu. Update it with Move to, Priority, or Labels; run an offered Automation from Automations; or use Resume last session when Volli offers it. Archive keeps the ticket for later restoration. Remove worktree… removes its checkout but keeps the branch.

See Manage tickets for ticket activity and archiving, and read Clean up worktrees before you remove a checkout.

Each card is a ticket with a title and a Ticket Body that records its scope. These tasks have their own guides: