Skip to content
OneviumDocs
On this page

Menu-bar hub: sessions, usage, codes and passwords

Open Quick access from the macOS menu bar or the Windows system tray to handle sessions waiting for you, check usage, copy codes and secrets, generate passwords, and set up shortcuts and the Dock menu.

What Quick access does#

Quick access is a small separate window that opens from the Onevium icon in the macOS menu bar (the system tray on Windows). Each of its five tabs has one job:

TabUse it to
OverviewSee sessions waiting for you, running and recent sessions, and today's recorded tokens
UsageCheck today's tokens, daily tokens for the last 7 days, and today's top models
CodesSearch and copy one-time codes saved in your vault
SecretsSearch and copy passwords, access keys and other secrets from your vault
GenerateGenerate a password on this device, copy it or save it to the vault, and review password history

Quick access only shows, locates and copies. Clicking a session opens it in the main window; it never approves a request for you. You need to be signed in to Onevium in the main window; otherwise the window shows Sign in to Onevium to continue.

Open and close it#

  1. Keep Onevium running. On macOS, find the Onevium icon in the menu bar at the top of the screen; on Windows, find it in the notification area at the right of the taskbar.
  2. Click the icon. Quick access appears next to it. If a session is waiting for you, it opens on Overview; otherwise it returns to the tab you used last.
  3. Click the icon again, press Esc, or click another window to close it.

The icon also has a right-click menu: Quick access opens Overview, and Open workspace brings back the main window. The ↗ button in the top-right corner of Quick access is also Open workspace.

To keep it open while you work elsewhere, click the pin (Pin window) in the top-right corner; click it again to unpin. While pinned, Overview and Usage keep updating, and codes are shown only while the window is in front. Locking the screen or putting the computer to sleep closes Quick access even when pinned.

When sessions are waiting for you, macOS shows the count right next to the menu-bar icon (99+ above 99). On Windows, hover over the tray icon: the tooltip reads, for example, "Quick access (2)".

Overview: handle sessions waiting for you first#

Example: you asked the assistant to "Fix the checkout payment callback" in storefront-web and to "Organize the Q4 Amazon restock sheet" in amazon-ops. While you are reading in your browser, a 2 appears next to the menu-bar icon.

  1. Click the icon to open Overview (Figure 1).
  2. ① in Figure 1, Waiting for you: sessions waiting for you to approve a permission or answer a question, with how long each has waited. With more than three, click View all to search by session or project name.
  3. Click "Fix the checkout payment callback". The main window opens on that session; read the request there before deciding whether to allow it.
  4. ② in Figure 1, Running: check that the restock task is still going. Recent sessions below lists other recently updated sessions that are not running; All sessions opens the main window.
  5. ③ in Figure 1, Today’s recorded tokens: total, input and output. Click Details to open the Usage tab.

Figure 1: ① Waiting for you, ② Running, ③ Today’s recorded tokens. Isolated demo of the real 1.3.2 Quick access component with simulated sessions and usage, shown on a plain backdrop; the menu-bar icon and the system's translucent material are not shown.

With nothing waiting, the top reads Nothing needs your decision. Quick access lists up to 20 sessions per group; beyond that it shows N more in the main window.

Usage: today and the last 7 days#

Open the Usage tab:

  • Today’s recorded tokens: total, input and output. Usage is counted after each reply is saved, based on your local day.
  • Last 7 days: a bar per day, with today on the right.
  • Top models today: the models, and their connections, that used the most tokens today.
  • Open full usage details: opens Settings → Activity in the main window, with details and costs by model, connection and session.

The footer of Overview and Usage shows approximate CPU and memory for Onevium's own processes, excluding external tool processes.

Copy codes and secrets#

Codes and secrets come from your vault. If it is empty, add items first in Settings → Secrets and hosts in the main window; see Secrets and SSH hosts.

Copy a one-time code

Example: Amazon Seller Central asks for a two-step verification code.

  1. Open Quick access and switch to Codes.
  2. In the search field at ① in Figure 2, type part of a name, account, website or tag, such as amazon or prod.
  3. ② in Figure 2: each row shows the current code and the seconds left. Click the row, or select it with ↑ ↓ and press Enter.
  4. ③ in Figure 2: the footer shows Copied. Clipboard clears after 30 seconds. Paste it into the sign-in page.

Figure 2: ① Search, ② click an item to copy its current code, ③ confirm it was copied. Isolated demo of the real component; items, accounts and codes are fictional.

If a code is about to expire (about 1.5 seconds or less left), Quick access waits for the next code before copying, so the pasted code is still valid. After 30 seconds only the value Quick access copied is cleared; anything you copy afterwards is left alone. The + button next to the search field (Import verification codes) imports Google Authenticator export images or pasted setup links; review every account before saving.

Copy a password or another secret

The Secrets tab works the same way: search, select, click to copy. The right side of each row shows the kind of secret, such as "Password".

Copying a secret requires Touch ID. On a device that cannot authenticate this way (for example a Windows PC or a Mac without Touch ID), the Secrets tab shows This device cannot authenticate secret copying. Codes and password generation still work there; view secrets in the vault in the main window.

Generate a password and use its history#

Example: set a password for a new staff account in your store admin.

  1. Open Generate. By default it creates a 20-character password with uppercase and lowercase letters, numbers and symbols, excluding similar characters (① in Figure 3). Click the refresh button on the right to Generate again.
  2. Adjust ② in Figure 3 to the site's rules: drag Password length (8–64 characters), select or clear character types, and edit Allowed symbols if the site restricts them. Every rule change generates a new password immediately.
  3. ③ in Figure 3:
    • Copy password copies it to the clipboard, cleared after 30 seconds.
    • Save to vault: enter a Name in your vault (lowercase letters, numbers and hyphens, unique, for example shopify-staff-ops) and, if you like, a Description (optional), then click Save password. You will find it in the Secrets tab.

Figure 3: ① The generated password, ② length and character rules, ③ copy it or save it to the vault. Isolated demo of the real component; the password was generated randomly for the demo and not saved.

Passwords are generated on this device. Only passwords you copy or save are encrypted into the local Password history; intermediate results while you drag the length slider never enter it.

Lost the password you just copied? Click History next to Generate a strong password (Figure 4). History keeps the last 100 entries, each with its time, length and Copied or Saved to vault:

  • Copy copies it again after Touch ID.
  • Save stores an entry that has not been saved yet in the vault; saved entries show Saved.

Figure 4: Password history shows only time and length; copying asks for authentication first. Isolated demo of the real component with simulated entries.

If the system keychain is unavailable, you can still generate and copy passwords, but not save them or use history. Unlock the keychain and try again.

Set up shortcuts#

Since 1.3.2, every global shortcut for Quick access is Not set by default, and ⌥⌘K and ⌥⌘T are no longer taken as earlier defaults. To open it from any app, bind your own:

  1. In the main window, open Settings → Keyboard shortcuts and search for "quick" or "password".
  2. Hover over the command, click the Edit shortcut button that appears on the right, and when you see Press a shortcut..., press the key combination.
CommandOpens on
Open quick accessOverview
Open secrets quick windowSecrets
Open verification codesCodes
Open password generatorGenerate
  1. If the combination already belongs to another command, you see Already used by … and can choose Transfer or cancel. If it says Registration failed — may be in use by another app, pick a different combination.

In addition, the Quick access row at the top of Settings → Secrets and hosts has an Open quick window button that opens the Secrets tab and shows the bound shortcut. For each shortcut field, see the settings reference.

Dock menu, window title and translucency#

  • Dock menu (macOS): right-click the Onevium icon in the Dock to see Waiting for you, Running and Recent conversations, up to five sessions each. Click one to open it in the main window.
  • Window title: the main window's title shows the current session's name, so you can tell windows apart in the Window menu or the Windows taskbar; with no session open it reads Onevium. Quick access itself never appears in window lists or the taskbar.
  • Translucency: Quick access uses the system's translucent material on macOS and Windows 11, and an opaque background on Windows 10 or with hardware acceleration off. For an opaque background, open Settings → Appearance → Motion and performance and turn on Reduce visual effects; the system's "Reduce transparency" setting also makes it opaque.

Common problems#

ProblemWhat to do
No Onevium icon in the macOS menu barA crowded menu bar hides icons behind the notch or other status icons. Quit a few menu-bar apps you rarely use, or hold ⌘ and drag icons to reorder them. You can also use your own shortcut, or click Open quick window in Settings → Secrets and hosts
No icon in the Windows trayClick the ^ at the right of the taskbar to show hidden icons, then drag the Onevium icon onto the taskbar. On Windows 11 you can also turn Onevium on under Settings → Personalization → Taskbar → Other system tray icons
Clicking the icon opens the main windowOnevium opens the main window while it is still starting up. Click the icon again once startup finishes
"Sign in to Onevium to continue"Finish signing in in the main window, then reopen Quick access
"The system keychain is unavailable"Unlock the system keychain (the macOS login keychain) and try again. When a new version first starts and the keychain asks for your password, choose "Always Allow"
Secret rows cannot be clickedThe device cannot use Touch ID; codes and Generate still work, and secrets can be viewed in the vault in the main window
"Could not copy" after clickingSystem authentication was cancelled or failed. Click the row again and complete it
A shortcut does nothingCheck in Settings → Keyboard shortcuts that it is bound and shows no registration failure; since 1.3.2 no combination is bound by default
The request is still waiting after you clicked the sessionQuick access only locates the session. Read the request in the main window, then allow or deny it

Resolve a live confirmation

Open the hub and select an item waiting for you. Read its action, target and countdown before choosing an available response. Some requests still require the main window or typed input. A request that has expired or already been answered cannot be approved again. Use Permissions and confirmations to review timeout behavior by category.

Next steps#