Omniscio

Session list — per-section sort, filter chips and Overseer crews

Sort and filter each sidebar section on its own, and expand an Overseer to see its live crew. Covers the three orders each section header offers, the filter box and the banner that says how many rows the filter is hiding, and the crew list that folds out under an Overseer row.

On this page

What it is

The sessions sidebar splits the regular list into four sections — Interrupted, Live, Routine updates and Paused. This page covers the two ways you can now shape what those sections show, and the crew list that nests under an Overseer.

Nothing here changes anything until you use it. A sidebar you have never touched looks and behaves exactly as it always did.

Where to find it

The sessions sidebar. Each of its four section headers — Interrupted, Live, Routine updates and Paused — carries ONE ⋯ menu: the actions for every session in that section, with the sort and filter options at its foot. The OVERSEERS section is the one whose rows expand to show a crew, and its own ⋯ carries this page's sort, filter and count options for that section.

How it behaves

Nothing here changes anything until you use it: a sidebar you have never touched looks and behaves exactly as it always did. The three parts below are the per-section sort, the per-section filter with its hidden-rows banner, and the crew list that folds out under an Overseer row.

Sorting one section

Each section header has exactly one small ⋯ menu on its right edge, lined up with every other header's. Its top half acts on the section's sessions (Pause, Stop, Archive and so on); while the section is open, its foot also offers three orders, with a tick beside the one in use:

  • Recent activity — the default, and the order the app has always used: whichever session you last spoke to sits at the top.
  • Name (A–Z) — alphabetical by session name.
  • Stalest first — the sessions that have gone the longest without any activity come first. This is the one to reach for when you are looking for something that has quietly stopped moving.

Each section keeps its own choice. Sorting Live by name does not touch Interrupted, Routine updates or Paused. Routine updates (the collapsed section of helpers waiting on their lead — see routine-updates-section.md) has its own sort and filter, set from its own ⋯ menu exactly like its peers. The ⋯ on a header turns to the accent colour whenever that section is sorted or filtered away from its default, so a changed view is visible even with the menu closed.

The choice is remembered: it survives switching projects and restarting the app, and the same order is applied on your phone and to keyboard and swipe navigation, so next-session always lands on the row you can see next.

The Snoozed section has no order menu — it always runs soonest-wake-up first. Rows come back earliest first, and rows woken for the same moment are ordered by session id so the list never reshuffles between visits. That one order is what the block draws on both your computer and your phone and what the next/previous keys and swipes walk, so stepping through the block visits the rows in the order they appear. Snoozing a batch of sessions at once therefore parks them in a fixed sequence rather than the order you selected them in.

Filtering one section

Pick Filter this section by name from the same ⋯ menu and a small search box opens under the header. Typing in it narrows that section to the sessions whose name contains what you typed. It is case-insensitive, and like the sort, it applies to that one section only. Press Escape or the × in the box to clear it and close it; an empty box also closes when you click away.

The filter stays until you clear it. That is deliberate — but it means a filter you set and then forgot about could hide running sessions. So while a filter is on, the section shows a banner saying how many rows it is hiding and out of how many, with a Clear button beside it. That banner is on screen whenever the section is open and the filter is active. Even a filter that matches nothing keeps the section's header on screen and clickable, so you can always open it and reach Clear — a running session can never be hidden without the sidebar giving you the way back.

Hiding a type of row in Needs You

Needs You holds sessions and the notices tied to this project — an alert, a pull request waiting in the merge queue, a scheduled job asking for approval, a CLI approval, a triage item. Its ⋯ lists each type it is actually holding, with an eye glyph beside the ones you are seeing. Pick a type to hide it: the row's glyph becomes a crossed-out eye, every row of that type leaves the list, and the section banner says how many rows it is hiding and offers Clear.

Two details worth knowing. Only the types actually present are offered, and a type you hid stays in the menu even after its last row clears — that is the only way back. And hiding is remembered, so a type you hide today stays hidden tomorrow, including on your phone, where the same banner appears; it applies to keyboard and swipe navigation too, so next-session never lands on a row you cannot see.

The Group by type row in the same menu re-orders the section so each type sits together — sessions first, then alerts, pull requests, approvals and triage — keeping the oldest-first order inside each group. Pick it again to return to one plain time order.

Filter chips — narrowing by owner, place, who started it and activity

Each of the four regular sections can be narrowed by filter chips, and so can the whole list at once. Nothing shows until you add one — a sidebar with no chips looks exactly as it always did.

Add one to a single section: open that section's ⋯ and pick Add a filter to this section. Add one to every section at once: pick Filter all sections from any regular section's ⋯ (the same rows are on your phone's Live menu). The + Filter button beside the chips opens the same picker.

There are two ways to pick filters, and a Panel | Menu switch inside the picker flips between them in place. Your choice is remembered, including on your phone.

  • Panel (the default): a panel opens right under the header with one row of chips for each kind of filter, plus a Sort row inside a single section. Click a chip and the list narrows at once; click it again to undo it. The panel stays open so you can keep clicking, and Done or Escape folds it away. Your filters stay on after it folds.
  • Menu: a small Add a filter menu pops up. Choose a kind of filter, then tick the values you want to see.

Either way, each value shows how many sessions it would show, counted inside everything else that is already narrowing the list, so the number you see is the number you get.

The kinds of filter are:

  • Owner — Overseer (every Overseer listed in the project's Overseers section, the sessions listed under it, any mission-crew session, and the sessions the app itself starts as read-only workers — a crew judge, an AI code reviewer, a scribe or a summarizer) or Solo (sessions nothing else runs). Offered only while crews are switched on.
  • Where — Cloud, This computer, and one value per linked computer that has a session here, by its own name (JohnnyPC, OmniscioTesting, …). A session on one of your other computers is never counted under This computer. A phone cannot read your computer names, so there they are grouped as Other computers.
  • Started by — You, An agent or The system: the same three groups as the Started by filter in search.
  • Activity — Active in the last hour, Active in the last 24 hours, or Quiet for over a day.

Tick several values of one kind to see any of them (Cloud or JohnnyPC); different kinds combine (Solo and This computer). Each kind you use becomes a chip such as Where: Cloud, JohnnyPC — click the chip to change it, or its × to remove it.

A filter never hides a session silently. While a section's own chips hide rows, its banner says how many and offers Clear. While the all sections chips hide anything, a bar stays pinned at the top of the list — it does not scroll away — reading "Filtering every section — hiding N of M" with its own Clear. Whenever either one hides Live rows, the Live header reads "Live Sessions (19 of 113)". Hover that number to see the full split as a small table: Overseer and Solo against Cloud, Local and each linked computer, with totals.

Needs You is never narrowed by the all-sections chips, so a session that needs you can never be hidden by a filter you set for something else — it keeps its own row-type filter described above. Pinned, Overseers, Scheduled, Snoozed and Archived are not narrowed either.

Sessions a crew runs also carry a small crown on their row (next to the cloud mark a cloud session already shows), and hovering the row says so. The crew's own Overseer does not: its status dot is itself drawn as a crown, so a second one would only repeat it.

Chips are saved with the section's sort and filter, so they survive a restart and apply on your phone and to keyboard navigation too. If the crews feature is switched off (or has not loaded yet), the Owner kind is not offered and a saved Overseer/Solo chip is simply ignored, so it can never empty your list without a visible reason. A choice saved by the older Live count buttons keeps working — it shows as a chip.

Folding Live down to the working sessions

Working only on the Live section's ⋯ menu (desktop and phone) folds Live down to the sessions that are running or starting right now — the same ones the Live header counts — and hides the idle ones. While it is on, the header reads "N of M" and the banner under it says how many rows are hidden, with a one-click Clear. It is saved with the section's view, so it survives a restart and applies to keyboard navigation too; pick it again (now ticked) to turn it off.

Sorting and filtering the OVERSEERS section

The OVERSEERS header carries its own ⋯, with the same shape as the session sections' menus:

  • My order — the default: the order you built by dragging, with your folders where you put them.
  • Name (A→Z), Needs you first, Most crew — three ways to re-order the rows INSIDE each folder and among the ungrouped rows. Folders themselves never move, and dragging is switched off while one of these is chosen, so a drag can never write an order the sort would override.
  • Filter by name… — the same search box and the same "Filtering — hiding X of Y" banner the session sections use, with one click to clear it.
  • Show count strip — two toggles under the header, Waiting (n) and Running (n), each of which narrows the section to that subset. Their numbers add up to the section's own total.

While anything narrows the section the header reads "Overseers (17 of 60)" — even when the section is folded — and a filter that matches nothing keeps the header, the banner and its Clear on screen. An Overseer the filter hides does not disappear from the app: its session returns to the section it would normally sit in (Live or Pinned).

The choice is saved with the section's view, so it survives a restart and applies on your phone and to keyboard navigation.

Expanding an Overseer to its crew

The OVERSEERS section lists one row per Overseer that looks after the project you are viewing. Each of those rows now carries a small chevron on its left.

  • Click the chevron to expand the row and see that Overseer's live crew — the sessions it is currently running — nested underneath, each with its usual status dot.
  • Click a crew row to open that session, exactly as clicking any other session row does.
  • Click the chevron again to fold it away.
  • A row with no chevron belongs to an Overseer with no live crew right now.
  • The number in brackets after each Overseer's name — Box Scale (5) — is how many live sessions it owns: exactly the sessions the chevron would show you, so the two always agree.

The list is folded by default, so the section stays the same compact list it has always been until you open something. The fold is remembered per Overseer per project.

The crew is listed most important first: Foremen at the top, then sessions waiting on you, then sessions that are working, then the rest. Interrupted sessions (the red dot) are left out of the list and out of the number — including a parked crew member whose program was shut down while idle.

A big crew scrolls inside the list — about eight rows show at once and the rest are a scroll away — so one big mission cannot turn the sidebar into a wall, and nobody in it is out of reach. Scrolling with the cursor over a crew list moves the list while it has more to show, and the sidebar after that — a short crew never stops the sidebar from scrolling.

What the crew list does not include

  • The Overseer's own session. That is the row you just clicked, and it is already drawn above.
  • Crew members who have left. They are no longer part of the live crew.
  • Archived and interrupted sessions (stopped, ended or failed). They are neither listed nor counted. Paused sessions still are — they are parked, not finished.

Each session lives in one place. An Overseer's own session is drawn only in the OVERSEERS section, never a second time in Interrupted / Live / Routine updates / Paused — clicking it there used to make the sidebar scroll down to the duplicate. A swarm's live crew is the same: it lives under the swarm's row, so it is not repeated in the main list. A plain crew's members are not nested anywhere, so they stay in the ordinary sections, and the crew list is simply a second way to reach them.

On a phone the same rule is settled before the first screen paints. Those sessions used to appear in the list for a moment and then vanish as the app caught up (a separate request answered the "which sessions does an Overseer own" question after the list had already drawn). The answer now arrives with the screen itself, so an owned session is never drawn and then removed; the live data takes over the moment it loads, so a stale answer can never keep a session hidden.

Tags you can attach to a session, which also render as their own sidebar sections, are on Session tags. Hiding the sidebar for a stretch is on Focus mode, and putting a session away from the list is on Archive a session.

Last verified 2026-11-19