Label sessions and filter by them

September 15, 2026·Console

Sessions take labels. A Labels column on the sessions list shows them, clicking one filters the list, and a Labels control in the toolbar does the same without a chip on screen.

In paper console, the sessions list has a Labels column. Each chip is a label on that session; click one and the list filters to sessions carrying it. A Labels button in the toolbar opens the same filter as a picker, so you can filter by a label that isn’t visible in the rows on screen.

AllRunningCompletedFailed

Search sessions…

Session	Status	Name	Labels	User	Turns	Cost	Active
a3f8c21d	Running	wire outcome detector into cursor cache ~/code/papercomputeco/console		brian(You)	42	$18.40	12m ago
d91b04ee	Completed	fix flaky export-sessions test ~/code/papercomputeco/tapes		maya	11	$2.10	1h ago
7c25e9ba	Completed	migrate span search to direct reads ~/code/papercomputeco/tapes		brian(You)	67	$31.75	3h ago
f04a77c3	Completed	scaffold billing exporter cron ~/code/papercomputeco/infra	—	devon	24	$6.88	5h ago
c18e5a09	Failed	reproduce the label filter 500 ~/code/papercomputeco/tapes		maya	19	$4.02	yesterday

Live demo — open Labels in the toolbar, or click a chip in the Labels column

Pick more than one and the list narrows to sessions that carry all of them. Active filters show as chips above the table with an × to remove each.

To add a label, open a session and use the tag control in the detail panel. Labels are created explicitly: typing a name that doesn’t exist yet offers a Create action rather than creating it silently.

A few details:

Matching is on the whole label name, folded for case. Backend and backend are the same label; backend and back are not.
Skills take labels too, and the skills list filters by them the same way.

Open the sessions list and look for the Labels column.

Label sessions and filter by them

Start with paper