Tag manager (the tag model)
Session tags are one kind of thing. Every tag has a name and a colour, can be limited to certain projects, shown as its own collapsible group in the sidebar, renamed, recoloured or deleted, and is applied to any session that fits. This page explains the tag model: where tags are stored, which projects a tag is visible in, the ten-tag limit, deletion, and sidebar groups.
On this page
What it is
A tag is a short coloured label with a name (up to 30 characters), an optional description, a colour, and a project scope: either Global (available in every project, the default) or Specific projects. There is only one kind of tag — every tag can be renamed, recoloured, limited to projects, shown as a sidebar group, or deleted. Older typed-in tags were upgraded into full tags automatically; see session-tags.md.
A tag created without a chosen colour gets one automatically, worked out from its name. Existing tags keep their colour.
Tags are managed in one place: the Tags view (sidebar entry Tags) — see tags-view.md. Creating and editing a tag uses the same tag editor everywhere (name, colour, projects, sidebar group, description). Settings → Tags is now just a short card with an Open Tags button. Tags are put on sessions with the T picker — see session-tags.md.
Tags show as coloured chips in the session header, directly under the title of an open session. Sidebar session rows do not show tag chips or colour dots; use a sidebar group (below) to see tagged sessions in the sidebar.
Where to find it
The Tags entry in the sidebar (the Tags view), where you create, edit and delete tags. Settings → Tags has a button that opens it.
How it behaves
- Create. The + in the Tags view sidebar header (or New group… in the session sidebar) opens the tag editor: a name, an optional description (up to 200 characters), a colour (an automatic one if you do not pick), a scope, and the sidebar-group switch. A name that already exists (ignoring capital letters and accents) is refused. Typing a new name in the T picker also creates a full tag, available in every project.
- Edit. Select a tag in the Tags view and click Edit (or press E). Renaming, recolouring, rewriting the description, changing scope and toggling the sidebar group all work. Right-click a tag for Rename, Change color… or Delete.
- Which tags a session can use. A tag is visible in a session's project when it is global or its scope lists that project. Tags limited to other projects do not appear in that session's picker.
- Narrowing a tag's scope never removes it from sessions. If you limit a tag to certain projects, sessions outside them that already carry it keep it (the chip stays, and the × still removes it), but the tag no longer shows in those sessions' pickers, so it cannot be added again there.
- Ten tags per session. A session never gains an 11th tag, whatever adds it (picker, quick reply, automation, CLI). Hidden internal markers do not count.
- Delete. In the Tags view, Delete asks for confirmation ("removes the tag from N sessions") and then takes the tag off every session and removes it. The name can be used again afterwards. Deleting a project drops that project from any tag's scope; a tag whose only project was deleted becomes global.
- Removing from one session works the same everywhere (header chip, picker, Tags view): a Removed "name" toast with Undo; Ctrl+Z also undoes.
Related
- session-tags.md — applying tags with the T picker and the header chips
- tags-view.md — the Tags view, where tags are managed
- cli-tags.md — manage tags and apply/remove them from an external AI agent through the localhost CLI server
- bulk-select-sidebar.md — Shift+J/K multi-select for batch operations on tagged sessions
- snooze-a-session.md — another session-organisation primitive surfaced through the same overflow menu
Last verified 2026-10-10