Pin a session
Pinning lifts a session into its own Pinned section at the very top of the sidebar's session list, above Needs You and the rest of the project's list, and it stays there until you unpin it. Pin or unpin from the session's right-click menu, the ⋯ button on its row, or a whole group's header menu. The move is instant and quietly reverts if it cannot be saved.
On this page
What it is
Pinning marks one session as "keep this where I can see it". A pinned session moves out of the run of the list into its own Pinned section, the first section of the project's list — above Needs You and everything else — and it stays there until you unpin it.
- It is a flag, not a status. Pinning does not pause, stop, archive, save or restart anything — a running agent keeps running, an ended session stays ended. Unpinning hands the session straight back to whatever section its own status earns.
- It is its own section, not a sort weight. Pinned is a real sidebar section, always the top one: above Needs you and the rest of the project's list, on the phone as on the desktop. It is not "sort these rows first".
- Attention does not win. A pinned session that needs you stays in Pinned rather than appearing in Needs you as well. This is the one place where pin differs from Save, where a saved-but-needing-you session is shown in Needs you instead.
- Archived is excluded. An archived session never shows in Pinned — unarchive it first.
- It survives restarts. The pin is stored, not remembered by the window you happened to click in. Every open client follows: pin on the desktop and the phone's sidebar shows the same order.
Do not confuse it with three other things that also use the word "pin":
- Pin a project — pins a whole project above the scrollable project list (reorder-projects.md).
- Pin a command to the session bar — turns a session-header action into a one-tap button, set in Settings → Sessions → "Session bar" (session-bar-commands.md).
- Pin a sheet, prompt or bookmark — unrelated lists that keep their own favourites.
Where to find it
- Right-click any session row — in the sidebar or in the Inbox. Pin is in the first block of the menu, alongside Snooze and Save.
- The ⋯ button on the row (it appears when you hover the row) opens the same menu, so you never have to know about right-click.
- The ⋯ button on a group's header — the same menu pointed at everything in that group, so you can pin a whole section at once (see session-section-actions.md).
- With several rows selected, Pin applies to every selected session that is not already pinned, and Unpin to every selected session that is. The selection is cleared afterwards.
- Once pinned, the same menu shows Unpin instead.
- Drag it. Drag a session row from Live (or Interrupted / Paused) onto the Pinned section to pin it, and drag a pinned row down onto Live to unpin it. If nothing is pinned yet, a dashed "Drop here to pin" strip appears at the top of the list while you drag. Dragging a row that is part of a multi-selection pins or unpins the whole selection from that section.
There is no keyboard shortcut for pinning and no setting that turns it on or off — it is always available. The menu labels read "Pin to the top of the sidebar for quick access." and "Remove from the pinned area at the top of the sidebar."
How it behaves
Where the session goes. A pinned session is drawn in the Pinned section, at the top of the list above Needs you and everything else; the arrow keys, swipe and shift-click walk it first, and folding the section takes its rows out of that walk. Inside Pinned, the order is your own drag order — pinned rows are never re-sorted by time, so a session you drag above another stays above it. Unpinning drops the session back into whichever section its status earns, at its normal sorted position.
What happens when you click. The row moves the instant you click; the save to Omniscio's own database happens after, behind the scenes. If that save fails, the row snaps back to where it was — there is no half-pinned state and nothing to clean up. A pin or unpin that saved — from the menu or by dragging — is one Ctrl+Z away, with an Undo toast where that preference is on; a failed save arms no Undo, since the row returning to its old place is the whole visible outcome.
A finished session leaves the hub count. Pinning an ended session moves it onto the Pinned shelf and out of its project's interrupted-session count; unpinning puts it back into that count. So pinning is also a way to say "stop counting this one at me".
Everything else about the session is untouched. Messages, tags, colour, project, and whether the agent is running are all unaffected — this is purely a placement decision.
Related
- save-a-session.md — the neighbouring shelf: Save bookmarks without moving the row; a saved session that needs you surfaces in Needs you instead
- snooze-a-session.md — Snooze hides a session until a time; pin keeps it visible at the top
- archive-a-session.md — archiving removes a session from Pinned; unarchive it first
- session-section-actions.md — the group-header ⋯ menu that pins a whole section at once
- bulk-select-sidebar.md — Pin and Unpin applied across a multi-selection
- move-a-session.md — moving a session between projects, together with its place in the list
- session-bar-commands.md — the other kind of session pin: a command promoted to the session header
Last verified 2026-10-23