Header widgets
The named controls in Omniscio's titlebar: clicking one either acts directly or opens a small popover. Which widgets ship, how to rearrange them by dragging, and how a plugin contributes one of its own.
On this page
What it is
Header widgets are the named controls in Omniscio's top titlebar. Clicking a widget either triggers an action directly or opens an inline popover panel.
The header's right side is a drag-to-reorder row of blocks. The Shortcuts block is the rounded pill of pinned toolbar icons (which still reorder inside the pill). The shortcut bar holds only pinned shortcuts: the account (Balancer), hardcore, usage, agent-tool-wait, credits, land-queue, weather, git-running, needs-you, sessions-live and update-ready widgets render as standalone bare blocks alongside it, so each can be dragged to any spot in the row. The user drags blocks left/right to arrange them; the arrangement persists in headerBlockOrder.
Header widgets are not hardcoded — they live in the toolbar registry and render through the same pinned-item path (ToolbarPinnedItem) as every other toolbar control, so users own their header layout completely.
Where to find it
The named widgets
| Widget | Label | What it does |
|---|---|---|
account |
Account | Opens the account-switcher popover — shows usage, lets the user switch or add accounts, and links to Settings → Accounts. Always visible. |
hardcore |
Hardcore Mode | Shows the skull icon and look count while hardcore mode is both revealed and switched on. Hidden automatically when the mode is off. |
cpu-burst |
CPU Burst | Performance mode toggle. Visible only in dev builds (import.meta.env.DEV). |
helpdesk |
Get Help | Help desk console. In-development, visible only when the helpdesk unreleased feature is enabled. |
land-queue |
Land Queue | Branches waiting on the auto-lander and worktrees the ledger is holding open; its panel adds a third row for branches that are stuck — refused or handed back by the auto-lander, each needing a fix before it can land. Opt-in — it is not pinned by default, so it sits in the overflow until you add it. |
credits |
Credits | Your Omniscio credit balance in the header (a wallet icon and the amount). Click it to buy more credit without leaving what you are doing, or to turn on auto top-up: when your balance drops below an amount you choose, Omniscio adds the amount you choose from your saved card, never more than your monthly limit. The balance turns amber when it is low and red when it is negative or when auto top-up has paused because your card was declined, with a Fix card button in the panel. Pinned by default; shown only while you are signed in and Buy Credit is offered. Buying credit is covered in Buy Credit. |
agent-tool-wait |
Agent tool wait | How long agents are currently waiting on their tool calls — the middle of the last ten minutes with the slow tail beside it. Opt-in: not pinned out of the box in a normal install, so you add it from Settings → Widgets; a developer running the app from source gets it pinned. Full detail: agent tool-wait chip. |
needs-you |
Needs You | How many agents are stopped waiting on your answer: a question, a plan to approve or a permission to grant. Click it to open the one that has waited longest. It is narrower than the number beside the app name, which counts everything in your inbox (finished replies and alerts too). It goes quiet while Focus Mode is on. Opt-in. |
sessions-live |
Sessions live | How many agent sessions are running right now, counted the same way as the green numbers in the sidebar but sessions only (running recipes and cron jobs are not included). It goes quiet while Focus Mode is on. Opt-in. |
update-ready |
Update ready | A Restart to update button that appears only when an app update has finished downloading and you clicked Later on the update banner. Clicking it restarts the app to install the update. While the banner itself is showing, this stays hidden so the header never says it twice. Opt-in. |
How it behaves
How users manage widgets
There are two levels of arrangement:
- In the header (drag) — drag a whole block to reorder the blocks (the Shortcut bar via its hover grip, or a widget block directly — a tap still opens the widget's panel; a drag reorders). The block order saves to
headerBlockOrder. Inside the Shortcut bar, drag individual icons to reorder them within the pill (unchanged). The grip is a mouse-only handle: screen readers skip it and it is not a Tab stop, so keyboard users never land on a control they cannot press. - In Settings → Widgets (formerly "Toolbar") — show/hide any of the named widgets and reorder the icons within the Shortcut bar. Note: reordering a widget here no longer moves its header block position — the header drag does that.
Hiding a widget removes its block from the header (it stays in the registry — re-add it any time from the removed-items section). The only widget that can never be hidden is the Settings gear (settings).
Putting widgets on rows
With Settings → Lab → Custom header layout on, the header can have up to four rows and every widget can sit on any row, on the left or the right. Right-click a widget and choose Move to row, or open Settings → Widgets → Header layout to see all rows at once, with move buttons, an Add a row button and Reset header to go back to the original layout. A widget you switch off keeps its place, so switching it back on puts it where it was.
When the window is narrow, widgets are never cut off: they stay full-size and the row scrolls sideways (mouse wheel, trackpad swipe, the small arrows at the row's ends, or Tab). The Omniscio name hides behind the logo first and the breadcrumb folds to its arrows second, instead of being cut short. See Customize the header toolbar for the full list.
Existing users
When the account and hardcore widgets shipped, a one-time startup migration (runToolbarPinMigration, flag headerWidgetsPinMigrationCompleted) back-filled both IDs into the pinnedToolbarItems setting for users whose stored list predates these registry IDs. New installs see them in the default pinned set from the start.
The credits widget reached existing users the same way, through its own one-time migration (flag creditsWidgetPinMigrationCompleted). A user who had switched the widget off before it shipped is left alone.
The developer-only phone-simulator button (a phone with a small test flask in its corner, so it never looks like the Mobile Access phone; open / close the Phone Simulator window, lit while it is open) reached existing users through its own one-time migration (flag phoneSimulatorPinMigrationCompleted). It lands just ahead of the trail, Usage and Credits — the first of those still pinned — so Credits keeps its place right before Settings and existing installs match a fresh one. Non-developers never see it: it is hidden unless this is a developer build or Plugins → Developer Mode is on.
Codex-only accounts
A local Codex sign-in counts as connected even when there are no managed Codex accounts and no Claude account. The compact account widget keeps its small status display; hover it to read the account identity. For a local login with no reported email it says Codex CLI.
The usage widget reads Codex primary and secondary limits in a Codex-only setup. If Codex has not reported limits yet, the details explain that it is connected but readings are unavailable; that does not mean unlimited usage or a missing sign-in. When Codex is your configured default provider, the default hub uses the Codex name and icon while preserving a custom hub name or icon.
Related
Hub jumper covers the keyboard-first route to the same destinations the toolbar's icons open.
The Widget Library lists every header widget (built-in, plugin and script) next to the widgets of every other area, and adds or removes them with the same settings as Settings, Widgets.
Last verified 2026-11-08