Fleet rows

Before a fleet operation acts, see the rows its query line selects. There are four doors, and all show the same rows.

On the web: GET /fleet?q=<query line>&sort=<column> (src/web/pages/fleet.ts), linked from the fleet graph as "Rows".

Acting on the rows (web): under the table, a signed-in person picks a verb for the kind and a value, and chooses Preview (src/web/pages/fleet-ops.ts, src/web/fleet-act.ts).

In the terminal: "Fleet rows" in the palette (src/tui/screens/fleet.ts).

In the API: GET /api/v1/fleet/rows?q=<query line>&sort=<column> answers { kind, columns, items }: the same rows /fleet shows, for the caller, public repositories only when signed out.

In MCP: the flow tool with { q, sort? } answers { kind, columns, items }, the same rows /fleet shows, for the caller (public repositories only when the token's user cannot read more). A bad line, a bad sort or an empty q is an error with the reason, so an agent previews a line without applying anything.

The query line: a kind, then field:value terms that must all hold. Both doors show the same grammar under the line: one sentence, then each kind with its fields (GRAMMAR and fieldsOf in src/fleet/selection.ts).

KindFieldsColumns
repoowner, name, repo, autonomy, visibility, createdrepository, autonomy, visibility, app
runstate, kind, agent, issue, repo, cost, createdstarted, repository, kind, agent, state, cost
issuenumber, state, assignee (none for unassigned), label, limb, repo, created, updatedrepository, #, title, state, assignee

Every kind also has id, and all three share owner and name. Some examples:

Shared code and rules:

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs