Omniscio

Tags — Manage Tags and Browse Sessions by Tag

The Tags view is a sidebar entry and the one place session tags are managed. A single A-Z list of every tag sits in the middle column with session counts; selecting a tag shows a header with its name and session count, an Edit button (or press E) and Delete, and the right pane lists every session carrying the tag, grouped by project.

On this page

What it is

The Tags virtual project is where you manage tags and browse sessions by tag. It follows the standard three-pane layout: the project sidebar on the far left (where you click Tags), a tag list in the middle column at the width of a normal project's session sidebar, and the main panel on the right showing every session that carries the tag you select, grouped by project.

There is one kind of tag, so there is one list. Every tag appears in a single A–Z list with a coloured dot, its name and the number of sessions carrying it. Anything you can do to a tag — rename, recolour, limit to projects, show as a sidebar group, delete — you do here. Putting a tag on a session is done with the T picker on the session (session-tags.md); the model behind tags is on the tag manager page. Settings → Tags is a short card with an Open Tags button that brings you here.

What it shows

Tag list (middle column, resizable, default about 268 px). A header row has a TAGS label and a + button that opens the tag editor to create a tag. Below it a search box filters the list. Click a row to select it. While the list first loads, skeleton rows show; with a search that matches nothing, an empty state shows. Drag the edge to resize — your width is remembered. The same PRD Stack strip that appears in every project's sidebar sits at the bottom.

Selected tag header. Selecting a tag shows a header above its sessions with the tag's colour dot, name, session count, an Edit button and a Delete button. Edit (or press E while the Tags view is showing) opens the tag editor: name, colour, projects, sidebar group, and description. Delete asks you to confirm ("removes the tag from N sessions") and then removes the tag everywhere.

Sessions pane. Before you pick a tag it says "Select a tag". After you pick one it lists every matching session grouped by project; each group has the project icon and name, and groups are ordered by most recent activity. Each row shows the session title, status dot, project colour bar and last-activity time. Click a row to open the session. A tag with no sessions shows "Nothing is tagged with this yet"; if loading fails there is an inline error with Retry.

Where to find it

  1. Open Omniscio.
  2. Open Installed Plugins at the bottom of the side nav.
  3. Click Tags (pink Tag icon).

How it behaves

Pick a tag, see its sessions

  1. Open Tags. 2. (Optional) type in the search box. 3. Click a tag. 4. Click any session row to open it.

Create, edit, rename, recolour, delete

  • Create: click + in the list header. A tag you create without picking a colour gets an automatic one.
  • Edit: select the tag and click Edit (or press E).
  • Right-click a tag for Rename (the editor, focused on the name), Change color… (the editor, focused on the colour) and Delete. The menu closes on Escape, an outside click or after you choose. There is no right-click menu on mobile; use Edit and Delete in the header.
  • Delete: confirm, and the tag is removed from every session that had it.

Remove a tag from a single session

Every session row in the right pane has a × (visible on hover or focus on desktop, always visible on mobile). Middle-click or right-click on a row does the same. Removing it takes the tag off just that session; the row disappears at once and a Removed "name" message appears with Undo. Ctrl+Z also undoes. The message only appears once the removal has succeeded; if it fails, the row comes back and the error is shown. Clicking the row body still opens the session, and the × never navigates.

Mobile

Only one pane shows at a time. The tag list takes the full width; tapping a tag shows its sessions with a < back chevron in the header that returns to the list.

State and live refresh

Your selected tag and search text are remembered between visits. If tags change while Tags is open — applied from another window, deleted, edited by an automation or the CLI — the view refreshes by itself; you never need to reload.

Out of scope

  • No multi-tag intersect. One tag at a time.
  • No bulk operations on the sessions pane; to bulk-act on tagged sessions use the project sidebar (bulk-select-sidebar.md).
  • No /tags-view/* CLI routes; the tags themselves are reachable through cli-tags.md.
  • session-tags.md — applying tags with the T picker
  • tag-manager.md — the tag model, scope rules, sidebar groups
  • stats.md — the other "browse" virtual project on the Installed Plugins page
  • bulk-select-sidebar.md — Shift+J/K multi-select for batch operations on tagged sessions (run from the project sidebar, not Tags)

Last verified 2026-10-10