: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¶
nkeeps 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, soesccloses 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 beforerhands 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.
fon 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 (
pshows 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 defaultmineview).Sasks 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↳ PARENTin 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.