Omniscio

The side nav — three zones and folders

The leftmost column of Omniscio, titled Workspace: a sticky top (Inbox, Claude, Ask Omniscio, up to five pins), a scrolling middle in two sections (your own projects, then Plugins), and a sticky bottom (Marketplace, then Installed Plugins). Covers folders, pins, what appears where by default, and the one-time upgrade from the old Omniscio group.

On this page

The side nav is the leftmost column of the dashboard. It has three zones, and only the middle one scrolls.

What it is

  • Top (always visible): Inbox, Claude and Ask Omniscio (when it is switched on), in that order, then up to five items you pin. While the Get Help console is full screen, a Help Desk row also sits here.

  • Middle (scrolls): an automatic Agent sessions folder when other agents have started sessions, then two sections, each with its own heading:

    • {projectNounPlural} (your own projects, the folders you added), first;
    • Plugins — every built-in tool, channel and plugin you keep in the side nav — second.

    Each section heading ends in a + and a folder icon (see below). Each section holds its own folders and loose items, in the order you arrange them. With no {projectNounPluralLower} of your own yet the first section is simply empty; add your first from the + on the {projectNounPlural} heading, or from the ⋮ menu's Add {projectNoun}.

  • Bottom (always visible): Marketplace, then Installed Plugins, set off from the rows above by a line and a soft shadow. Installed Plugins opens a page listing every built-in tool — see tools-hub.md.

Claude, Ask Omniscio, Marketplace and Installed Plugins are fixed: they cannot be pinned, put in a folder or removed.

Where to find it

It is always on the left of the dashboard (or on the right if you moved it). The header is titled Workspace (with a count) and holds a search icon and ⋮, which holds everything else. The ⋮ menu starts with Add {projectNoun}, New folder in {projectNounPlural} and New folder in Plugins, then show only active and sort by usage, then collapse to icons, hide the side nav and move it to the other side. The ⋮ menu is also how you reach those add actions from the keyboard. The search icon appears once you have at least one project.

Each section heading ({projectNounPlural} and Plugins) ends in two small buttons that do the same things with the mouse. They are not Tab stops. The + on {projectNounPlural} adds a {projectNounLower} and is greyed out when you have reached your plan's limit; the + on Plugins opens the Installed Plugins page; the folder icon on either heading starts a folder in that section.

How it behaves

Folders

A folder belongs to one section: a folder in {projectNounPlural} holds your projects, and a folder in Plugins holds tools, channels and plugins. Each kind looks different, and each has a colour.

  • A Plugins folder has a bar in its colour at the left edge of its header, a faint wash of that colour across the whole row (a little stronger when you point at it), and its icon tinted. Its contents hang off a plain grey line with a small elbow into each item.

  • A {projectNounPlural} folder is written like a path, ~/name, in a typewriter face, with only the ~/ in the folder's colour — no bar and no wash. Its contents hang off a dotted line.

  • Make one: use the folder icon on the {projectNounPlural} or Plugins heading, or the header's ⋮ → New folder in {projectNounPlural} / New folder in Plugins; the naming box says which section the folder is for. A folder you make this way stays in that section for good — you cannot change it later — and lands at the top of its section. (Right-click an item → Add to new folder… also makes one, and so does New group… on the Installed Plugins page; those folders take their section from what they hold and land at the bottom.) Each new folder gets the next colour from a fixed palette (none of them a status red, amber or green). Each colour is drawn a little darker on the light theme so it stays easy to see, and grey (plain neutral) and slate (blue-steel) look clearly different.

  • Fill one: right-click an item → Move to folder (it lists only the folders in the item's own section), or drag it onto the middle of the folder's name (open or closed), which adds it to the end of that folder, or drop it between the items of an open folder. On the Installed Plugins page, a tool's Add to group puts it in a Plugins folder (see tools-hub.md), and so does the + beside a tool in the header search. Dropping anywhere else makes it a loose item. Remove from folder takes an item back out. A folder cannot hold another folder.

  • Folder menu: right-click the folder (or focus it and press the Menu key or Shift+F10) → Rename, Change icon, Change colour, Delete folder. There is no menu button on the header, and no Add entry in the menu — items join a folder in the ways above. Deleting moves the contents out as loose items, with an Undo; nothing inside is deleted. An empty open folder shows only a small gap you can drop an item into.

  • Give a folder its own icon or emoji. Change icon opens the same picker {projectNounPluralLower} use — a grid of icons and a grid of emoji — and the one you pick is drawn before the folder's name. No icon in that picker puts it back to the plain look. A folder you never give an icon looks exactly as it always has, so nothing changes until you choose. In icons-only mode the chosen icon replaces the letter the folder would otherwise show, which is what makes a collapsed sidebar readable at a glance; folders with no icon keep their letter, so they stay distinguishable.

  • A closed folder always tells you when something inside needs you. It shows a combined badge (amber, or red if anything inside has an error), and it opens by itself the moment something new needs you. Once you close it, it stays closed until the next new thing arrives. Focus Mode silences the badge. In icons-only mode the folder shows a coloured dot instead and never opens by itself — see sidebar-collapse.md.

  • In the Master layout, a folded group shows what it hides. A folded group heading (such as Omniscio (60)) shows the summed numbers of every row inside it, one per colour — red, interrupted, amber, waiting, green and unread — beside its item count, and a folded category row (such as Communication) shows its own numbers plus its hidden children's. Hover the numbers to read what each one means. Opening the group hides the totals, because each row then shows its own.

  • A folder keeps to its section. Your projects go in {projectNounPlural} folders, and built-in tools, channels and marketplace plugins go in Plugins folders. Dragging an item into the other kind (or reordering it into the other section) does nothing, Move to folder does not list the other kind, and a request that tries it from outside the app (the local control API) is refused. The one drop that does something different: a plugin dropped right under an open {projectNounPlural} folder is placed first in the Plugins section, as a loose item, instead of snapping back. A project dropped under an open Plugins folder is still refused. If an item somehow sits in a folder of the other section (a folder made before sections existed and holding a mix), it is drawn loose in its own section, and its saved folder is left alone. Folders made before sections existed take their section from what they hold: all projects and not empty means {projectNounPlural}, anything else Plugins.

  • The Agent sessions folder opens and closes like any folder, and Show only active leaves it as you set it. While you search, it shows only the agent sessions whose name matches, opened, and disappears when none match.

Pins

Drag an item into the top zone to pin it, or right-click it and choose Pin to Top if your sidebar offers it; a pinned item's menu always has Unpin. You can pin up to five items; a sixth is refused with "Top is full — unpin something first." Only pins you can see count: taking a pinned item off the side nav also unpins it (its Undo pins it again). A pinned item remembers its folder, so Unpin puts it back there. Claude and Ask Omniscio are fixed and never count toward the five.

What appears in the side nav by default

  • Projects: always.
  • Channels you turn on (Gmail, Slack, Telegram…) and plugins you install: added automatically.
  • Built-in tools: not added — they live on the Installed Plugins page, where each has an In side nav switch. Right-click a tool in the side nav → Remove from side nav to send it back there. The message that appears offers Undo and Open Installed Plugins.
  • Only tools, channels and plugins can be taken off the side nav — the Installed Plugins page is how they come back. A project stays; it has its own Remove in its menu.

Upgrading from the old Omniscio group

The first launch after this change tidies the side nav once:

  • built-in tools you opened in the last 30 days, tools you had pinned, and tools you had put in your own groups stay in the side nav, and so do tools that open a dialog instead of a page (Super Prompts, Bake-Off, AI Council and the like), because their past use was never recorded;
  • every other built-in tool moves to the Installed Plugins page (if Omniscio cannot read your usage, every tool stays);
  • your own groups become folders and get colours, in the order you had them — groups you had pinned come first, then everything else as it was, with the old Omniscio group's items where the group sat;
  • if you had more than five pins, the first five stay pinned and the rest are unpinned — an unpinned item that was in a folder stays there, and one that was not goes to the top of the middle.

The old Omniscio group and its categories stay in the database untouched; the side nav just doesn't draw them. The categories now organise the Installed Plugins page.

Which session opens when you switch to a project

Clicking a project — or switching to it from the keyboard (Ctrl+number, next/previous project, or the project jumper) — opens one of its sessions for you, picked in this order. Both ways land on the same row:

  1. The session you already have open, if it belongs to that project — but only when you are already in that project, or nothing in it needs you. Arriving from anywhere else (another project, the Inbox) with a chat of that project still open, Needs You wins and its top row opens instead.
  2. The session you were reading when you last left that project — so a round trip puts you back where you were. Overseer sessions are the exception: if you left a project while reading an Overseer, coming back opens the top of Needs You instead (you deal with Overseers through their inbox cards and open them on purpose from the Overseers section). The Back button and the phone Back gesture still return you to the exact session, Overseer included.
  3. The top row of Needs You — the same row the list shows first, oldest waiting first, whether it is a session or a card (an Overseer's card, an alert, an approval). A card opens right there in the project, exactly as if you had clicked it. Overseer sessions and pinned sessions live in their own sections, so they are never this row. An opened card stays on screen: the hub never then starts a blank chat over it, even when none of its chats are active.
  4. The most recent session, preferring one that is not an Overseer.

The Approvals hub has no sessions, so it skips straight to its own top row: switching to it opens the first approval under "Needs you now", or nothing when the queue is empty.

Status counts on rows

Each row keeps its status counts — red for errors, amber for needs you, ember orange for waiting, green for running. The numbers come from the backend, so the phone and desktop agree. A folder's badge is the sum of the numbers its items already show.

The red number counts the sessions in that project's Interrupted list, so it equals the Interrupted (N) header when you open the project. A pinned or saved session is not counted: it shows in its own Pinned or Saved section. A rate-limited session sits under that header but carries the separate orange count, so the header equals red plus orange. Opening a busy project loads its whole Interrupted pile, so the two numbers match even on a project full of running sessions (fixed 2026-09-24). A session that genuinely cannot recover ("Recovery failed") waits in that project's Interrupted list too — it has no Inbox row and does not chime.

The Alerts row shows an amber count of the alerts the Agent Alerts screen is listing; an alert raised against a real project also counts on that project's own row, and snoozing it removes it from both. Those are real alerts only: a card an agent session raised is a message, is not listed on that screen, and is not counted here. Middle-clicking the Alerts row offers to clear exactly the alerts that screen lists — never an agent's message — and with nothing listed it offers nothing.

The Automation Rules row shows an amber count of automation rules waiting for your approval (rules an agent created that you have not approved yet). They count there, on the screen that lists them, and nowhere else in the side nav — not on the Texts, Gmail, Telegram or Slack row a rule is for, and not on Cron Jobs. With the Automation Rules screen switched off, its row is hidden and a waiting rule shows only in the Inbox badge. Middle-clicking the row offers to reject exactly those rules, behind a confirmation that warns it cannot be undone.

A plugin with rows in your inbox shows that count on its hub. Whatever a plugin puts in the Inbox (Newsletter Builder's unread issues and "Could not finish…" notices, for example) is counted onto that plugin's hub row as an amber number, on desktop and phone alike. The plugin's own unread pill, when it sets one, still shows beside it. Before 2026-10-06 plugin inbox rows were never counted, so a plugin hub with seven rows in the Inbox showed no number, and "show only active" hid it.

A long menu folds into sections

Every menu in the app reads the same way once it has grown past a dozen rows: instead of one long list, it shows a few labelled sections — Project, Insights, Organize and so on — and you open the one you want. A freshly opened menu starts with them all closed; opening a second section leaves the first one open, so you can read across two groups at once.

  • The rows that remove or erase something sit under their own Danger heading at the bottom, and that heading never folds: a destructive action is always one click away, never hidden.
  • A menu short enough to scan — a text menu, a colour menu, a folder menu — is unchanged: no sections, exactly the rows it had before.
  • A section that would hold a single row shows that row directly instead of putting a heading over one item.
  • A filter box, where a menu has one, expands every section while you type, so typing never misses a row that is collapsed.

This is the same section model the session ⋯ menu has used since 2026-06, now shared by every long menu rather than re-implemented per screen.

Keyboard

The side nav is one list for the keyboard: Tab enters it once, then the arrow keys move between rows and folders, ←/→ close and open a folder, Home/End jump to the ends, Enter opens the focused item, and typing a letter jumps to the next row starting with it. The Menu key or Shift+F10 opens the row's menu. Ctrl+Shift+↑/↓ reorders the focused item (see reorder-projects.md).

Phones

The phone's project list shows the same order, folders and badges, with everything scrolling together (Inbox is reached from the phone's own navigation). Your projects come first and Plugins after, as on the desktop, but the phone does not draw the two section headings or their + and folder icons. Long-press an item or folder for its menu; the phone's folder menu still has an Add entry, and its Move to folder lists only the folders of the item's own section.

Two desktop behaviours work the same on the phone:

  • Search shows tools too. While the search box has text, a Tools group appears beneath the matches (and beneath "No {projectNounPluralLower} match") listing built-in tools that match but are not in the side nav. Tap one to open it, or tap + to add it to the side nav (the same small menu as on the desktop: Add to side nav, or straight into one of your Plugins folders); a switched-off tool offers Turn on instead. It is the same group the desktop search shows.
  • Folders open themselves. A closed folder opens once when something inside it starts needing you (or needs you more than before). It never reopens just because its badge is non-zero, so you can close it again, and it stays shut while Focus Mode is on.

Last verified 2026-10-09