---
title: 'Menu-bar hub: sessions, usage, codes and passwords'
description: >-
  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.
canonical_url: 'https://onevium.com/docs/menu-bar-hub'
language: en
updated_at: '2026-11-10'
publisher: Onevium
minimum_version: 1.3.3
---
> Source: Onevium official documentation
> Article: Menu-bar hub: sessions, usage, codes and passwords
> Original URL: https://onevium.com/docs/menu-bar-hub
> Language: English
> Updated: 2026-11-10
> Applies to: 1.3.3+

---

# 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:

| Tab      | Use it to                                                                                        |
| -------- | ------------------------------------------------------------------------------------------------ |
| Overview | See sessions waiting for you, running and recent sessions, and today's recorded tokens           |
| Usage    | Check today's tokens, daily tokens for the last 7 days, and today's top models                   |
| Codes    | Search and copy one-time codes saved in your vault                                               |
| Secrets  | Search and copy passwords, access keys and other secrets from your vault                         |
| Generate | Generate 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.

![Quick access Overview: two sessions under Waiting for you, two Running, two recent sessions, and today's total, input and output tokens at the bottom](https://onevium.com/assets/docs/menu-bar-hub/en/menu-bar-hub-01-overview.png "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](https://onevium.com/docs/secrets-and-ssh).

### 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.

![The Codes tab lists six sample items, each with a six-digit code and countdown; the first row shows a copied check mark and the footer says the clipboard clears after 30 seconds](https://onevium.com/assets/docs/menu-bar-hub/en/menu-bar-hub-02-codes.png "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.

![The Generate tab: a 20-character password with a regenerate button at the top, the length slider and character-type checkboxes in the middle, and Copy password and Save to vault buttons below](https://onevium.com/assets/docs/menu-bar-hub/en/menu-bar-hub-03-generator.png "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**.

![Password history lists three entries with time, length and Copied or Saved to vault status, with Copy and Save buttons on the right](https://onevium.com/assets/docs/menu-bar-hub/en/menu-bar-hub-04-history.png "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.

| Command                   | Opens on |
| ------------------------- | -------- |
| Open quick access         | Overview |
| Open secrets quick window | Secrets  |
| Open verification codes   | Codes    |
| Open password generator   | Generate |

3. 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](https://onevium.com/docs/settings/reference#keyboard).

## 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

| Problem                                                    | What to do                                                                                                                                                                                                                                                       |
| ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No Onevium icon in the macOS menu bar                      | A 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 tray                                | Click 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 window                    | Onevium 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 clicked                              | The 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 clicking                            | System authentication was cancelled or failed. Click the row again and complete it                                                                                                                                                                               |
| A shortcut does nothing                                    | Check 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 session | Quick 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](https://onevium.com/docs/permissions) to review timeout behavior by category.

## Next steps

- Add website accounts, codes and server credentials in [Secrets and SSH hosts](https://onevium.com/docs/secrets-and-ssh).
- Learn why sessions wait for you in [Choose a work mode and permission profile](https://onevium.com/docs/permissions).
- Organize the sessions listed in Quick access with [Organize projects and sessions](https://onevium.com/docs/projects-and-sessions).
