Labels are tags you apply to captured sessions and skills — a shared, organization-wide vocabulary for grouping the work that matters: a release, an incident, a customer, an experiment. Create a label once, attach it by name, then filter and sort your history by it. You work with labels in paper console today, with paperctl commands rolling out.
Label and filter in the console
Apply labels. Open a session (or a skill) and use its Labels panel to attach labels. Start typing to search existing labels, or create a new one inline — a label is created only when you explicitly choose to, so a typo never mints one by accident. Remove a label from the same panel. Names render exactly as you type them, emoji included.
Filter by label. Click a label chip on the sessions table to filter the list to that label. The active filters show in a bar above the list; add more labels to narrow further — filters combine with AND, so a session has to carry every label to match. Filtering runs server-side across your whole history, not just the page you’re looking at. Skills filter by label the same way.
Manage labels. Open Labels from the account menu for the full list — each label’s color, display name, description, and how many sessions and skills use it. Rename or recolor a label inline, or delete one. Deleting a label removes it from everything it was attached to.
Sort the sessions list
Click any column header in the sessions table to sort by it — cost, date, and the other columns. The first click sorts descending (largest or newest first); click the same header again to flip the direction. On smaller screens, the sort control offers the same options. Sorting pairs with label filters: narrow to a label, then sort the matches by cost to find the expensive ones.
From the CLI
Create, attach, and filter by labels from the terminal:
paperctl label create incident-2026-09 --color "#EA4335" --description "Sept billing outage"
paperctl label add <session-id> incident-2026-09 --create # --create mints names that don't exist yet
paperctl label list # every label with color, description, usageAttach labels as you capture, and filter sessions list and search by them (repeatable, combined with AND):
paperctl start --label incident-2026-09 claude
paperctl sessions list --label incident-2026-09
paperctl search "why did the retry loop stall" --label incident-2026-09Rename and delete mirror the console; label delete detaches the label everywhere and needs --force off an interactive terminal.