Cockpit filter

The filter box at the top of the cockpit (/ focuses it) narrows every view to the pull requests whose number, repository, title, author, head branch, workspace, board column, reason, card comment, brief goal or brief tag holds every word typed, ignoring case and accents. Pasting a pull request URL opens it.

In the task views (Inbox, Needs me, Waiting, Someday, Projects, Outbox, Logbook and the others of your views.toml) the same words narrow the tasks: their title, notes, state, kind, items, the people they wait on or come from, their channel or repository, project, area, contexts, the text of their message or draft, and the values of their facets (those of their own facts, their brief and their units’ rows, such as a pull request’s checks), ignoring case and the accents of Portuguese and Spanish. Qualifiers narrow the tasks too, over their facets, and the rail counts them as the list shows them. The terminal’s / filter does the same in task views and row views, and = and - group and sort over the fields the view offers.

The counts follow the filter in every view. The rail (the tabs in the terminal) counts what each view shows under the filter, the toolbar above a list reads “N of M” (what the filter shows of the view), and the group headings, the area picker and the context chips count the matches. With no filter, the counts of the lists are those of the whole views.

Qualifiers

Qualifier	Matches
where:	where the unit lives: a pull request’s repository (where:api matches any owner) or a Slack channel
author:	the author; author:@me for yours (@me is an alias of me in every qualifier)
wait:	a pull request’s strip: whom it waits on, by role: me, loop, reviewer, author, nobody (GitHub)
turn:	whose turn it is: me, others, nobody; a Slack conversation’s strip, and a task’s, from whom it is owed by
waits-on:	a person or team it waits on
kind:	a pull request’s situation (GitHub)
situation:	a Slack conversation’s situation: waits_on_viewer, needs_closure, new, waits_on_others, fyi, resolved
age:	how long it has waited in its situation: 1d, 3d, 7d, 2w, 4w, older (GitHub and Slack)
type:	the brief’s kind: feature, fix, refactor, chore, infra
risk:, size:	the brief’s risk and size
status:	the workspace’s board column
is:	stalled, needs-me, in-loop, approved (the GitHub plugin’s own reading of the row; the lens views Stalled, In loop and Approved list tasks, reading its link signals), due (an automatic round’s plan gate deadline, mute end or brief retry within a day), paused, muted, adopted, tracked
ci:	failure, pending, success, none, or the name of a failing check
opened:	age since it opened: 1d, 3d, 7d, 2w, 4w, older
scope:	a scope reason
tag:	a brief tag: tag:lang:python that tag, tag:lang any lang: tag

A facet value that is false, zero or empty is no value: it is not matched by a qualifier and forms no group. A task view also takes the task facets of your views.toml; the bundled ones are source: (github, slack), state:, category:, turn:, asked-by:, placement:, moved: (1d to older, since it last moved), gates:, signal: and prop.<name>: for an enum property, beside the facets of its units’ rows above.

Values of one qualifier widen, different qualifiers narrow, and a leading - leaves a value out:

where:api is:stalled -author:@me
wait:reviewer size:l size:xl
ci:failure tag:lang:go

Clicking a repository, author, person, situation, type, size, risk, tag or column on a row filters by it, Shift+click groups by it, and Alt+click leaves it out.

Grouping, sorting and boards

The toolbar above the list groups, sorts and switches between list and board in any view, task views included; the Group and Sort menus offer only the fields some item of the view has. A removable chip shows each qualifier of the filter, and Filter (+) adds one from a palette of the view’s fields, then the values its items hold. A task view groups by its group until you pick another field or None; a board with no grouping groups by whom a row waits on. Grouping offers one “Tag <key>” per tag key present; an item with two values of that key shows in both groups. Filters, grouping and order stay in the URL and follow you across views; a group or sort a view does not offer gives way to its default.

The Backlog view

Backlog charts the open pull requests above the list: what needs you, is stalled, sits in the loop, is approved or comes due; whom they wait on; repositories and situations; tag concentration; size against risk; how long each one has waited, with the stalled threshold and the 50th and 85th percentiles; what happens in the next 72 hours; and the tokens or US$ the loop spent on each. Clicking a bar, tile or point filters by it like a qualifier. “Include done” brings merged and closed pull requests back in.