The board, list, and activity views
The board at a glance
At the top of the page is the project header: its name and description (click either to rename or edit inline, if you have project:write), a status badge (Active, Provisioning, Needs attention, Archived, or Deleting), a workspace label, and, if you can manage integrations, a Slack channel link. Two icon buttons sit on the right: a pencil to edit the project, and an archive icon that toggles Archive project / Unarchive project. A degraded project shows an amber banner with a Retry setup button if the problem is retryable; a provisioning project shows a blue "setup is running" banner instead.
Below that is a three-tab bar:
- Board: the Kanban view, and the default tab.
- List: a flat, grouped list view.
- Activity: a chronological feed of everything that happened on the project's cards.
The Board tab
Five columns, always in this order, each with a live card count and a short subtitle:
| Column | Subtitle | Meaning |
|---|---|---|
| Backlog | Captured work | Ideas and triaged issues, not yet queued |
| Todo | Ready to start | Queued and ready for an agent (or a human) to pick up |
| In Progress | Actively working | An agent is planning or implementing right now |
| Review | Human checkpoint | Waiting on you: a decision, a question, or a confirmation |
| Done | Completed work | Finished |
Each empty column shows its own hint text (for example, Todo's reads "Nothing queued up — Drop an issue here when it's ready for an agent or human to pick up.").
Above the columns is a filter bar with exactly two controls:
- A "Filter cards..." free-text search box that matches against the card's title and its id (for example, typing
7also matches a card whose id isABC-007). - A card type dropdown: Stories, Tasks, All cards, in that order. The board opens filtered to Stories, so Task-type cards are hidden until you switch this yourself. This filters on the card's own type tag, not on parent/child relationship.
There is no agent filter, no status filter (the columns already are the status filter), no repo filter, and no priority filter anywhere on this board. None of these exist in the product today.
Cards you can move are dragged between columns; a locked card cannot be dragged and shows a closed cursor instead of a grab cursor:
- Backlog ↔ Todo is a plain reorder, and needs
issue:write. - Dragging a Backlog or Todo card into In Progress dispatches it to the agent. It needs
issue:run, and immediately kicks off a run. - You cannot drag a card into Review or Done yourself. Those transitions only happen through the checkpoint and approval flow (see Card review and human input) or automatically as a run finishes.
- Once a card is In Progress or in Review, it cannot be dragged at all: a live run, not you, owns its position.
Hovering a card reveals a "⋯" actions menu with Open details (same as clicking the card) and, if you have issue:delete, Delete issue. Hovering a Done-column card also reveals an "Archive issue" affordance, but it does not do anything when clicked today; deleting is the way to remove a finished card from the board.
The List tab
List groups every card by status into five sections (Backlog, Todo, In Progress, Review, Done), each with a coloured status dot and a count. Within each group:
- Parent cards (no parent of their own) are listed first. A parent with children also in that same status group shows them nested underneath, indented, with a chevron to collapse or expand (expanded by default) and a "· N sub" note next to the parent's id.
- Children whose parent sits in a different status are listed standalone in their own status group, marked with a bent arrow and a
↳ {parent title}hint.
Each row shows the card's id, its type tag, the title, and a relative timestamp; clicking any row opens that card's detail page. There is no pagination or row-count control here, and every card in the project loads at once.
The Activity tab
A plain chronological timeline of everything that has happened across the project's cards, grouped by day, each entry showing who or what did it (an agent or a person, with an avatar) and a relative time. When there is nothing yet: "No activity on this project yet."
How do I create an issue?
Click New Issue in the top-right of the project header (visible only with issue:write). This opens a modal titled {Project name} › New issue with exactly two fields:
- Title: plain text, placeholder "Issue title". Required.
- Description: a rich-text editor (placeholder "Add a description…") with a formatting toolbar: Heading, Bold, Italic, Bullet list, Numbered list, Quote, Code block. Optional.
That is the entire form: no field for type, priority, assignee, repository, or due date. Every issue created here becomes a Story, in the Backlog column, in whichever project the modal was opened from (a line under the button confirms it: Issue will be created in {Project name}.). Click Create issue to save, or close the modal to discard your draft.
Because everything lands in Backlog, creating an issue is deliberately a two-step motion: capture it here, then move it to Todo and on into In Progress (by drag, or from the card's own Start banner) when it is actually ready for an agent to pick up.