Skip to content

:issues — browse and dispatch

Aliases: i, is. Argument: a team key, all, or mine (:issues CLOUD).

The tracker's issues as a sortable table — id, parent link for sub-issues, priority, title, labels, state, assignee. Issues already on the board are filtered out, so what you see is what you could still dispatch.

Keys

key what
/ fuzzy filter. #bug or label:bug by label; parent:CAD-12 or parent:cadence by what an issue is part of — the issue above it or its project, since both answer the same question
t switch team (the provider's word for it — team, project, repo)
l add a label filter · s sort by any column · p include/exclude project issues
S sub-issues on/off — pull in the children of the issues listed, under their parents
space select — actions apply to the selection, or to the row under the cursor
enter dispatch
D dispatch, skipping triage
c custom dispatch: model, repo, whether to triage, whether to start — and a paragraph-sized instructions box (enter is a newline there, ctrl-d dispatches). A row with more options than fit scrolls with ←→, marked ‹ ›; names are never cut in half
n new issue: a team and a priority, each auto or set, and a big box for the request. An agent drafts the title and body and files it. See new issues
o open in the tracker · b board · r refresh

New issues

n opens a form with the cursor already in the request box. It's the big box, and it takes most of the screen, because the request is what the drafting agent works from.

field auto set
team the agent picks one of your teams from what the request is about, and the toast says which filed there
priority the agent sets one only if the request implies it filed exactly as given; none means no priority, on purpose

The team starts on the one you're browsing, and on auto from "mine" or "all". With many teams, a letter on the team row jumps to the next key that starts with it. tab and shift-tab move between fields, ←→ chooses, and ctrl-d creates from the box, since enter is a newline there.

auto can only land on one of your teams. The agent answers with a team key from the list it's given, and an answer that isn't one of them fails the draft rather than filing into a guess.

Notes

  • n keeps you in the loop while it works: a progress popup streams the drafting agent's activity, then holds the result — created CLO-214, or the failure — until you dismiss it. The agent runs in the daemon, so esc closes the popup and not the session: the draft keeps going, shows up in :agents, and the toast still lands when it files the issue.
  • c → start: manual — worktree only cuts the worktree and stops, leaving the card in Working for you to lay a skeleton down before r hands it to an agent. See dispatch.

  • Dispatching self-assigns the issue and moves it to In Progress immediately (stateSync), not when an agent slot frees up.

  • Issues with unresolved blocking relations park as ⛓ blocked in the Queued column and start automatically when their blockers finish. f on the board starts one anyway, keeping the blockers as merge-order dependencies.
  • Queries paginate with a 500-issue cap; the default view hides project issues (p shows them).
  • Sub-issues are usually missing for reasons that have nothing to do with being sub-issues. They inherit their parent's project (hidden unless p), or they belong to whoever picked them up (hidden in the default mine view). S asks for them by parent instead of relaxing those filters, so the list keeps meaning what its header says: one extra query, children placed directly under the parent they belong to, and a ↳ PARENT in the parent column. A child whose parent isn't in the list stays where the sort put it. Providers without sub-issues (capabilities.subIssues) ignore the key.
  • Custom views are saved filters that render in this same table — see configuration.