NebulaNebula
Desktop

Shortcuts & tray

Summon Nebula with a keyboard shortcut, keep it running in your menu bar or system tray, and pop threads out into their own windows on desktop.

Desktop keeps Nebula a keystroke away and out of your dock. Summon it with a shortcut, leave it running in the tray, and pull individual threads into windows of their own.

Keyboard shortcuts

ActionDefaultScope
Summon or dismiss Nebula Space / Ctrl SpaceAny app
Quick Send ` / Ctrl `Any app
Mute microphone M / Ctrl MOnly during a call
Settings ,macOS only
Quit Q / Ctrl QThe app

The first three are re-recordable in Settings → Shortcuts. If the combination you pick is already claimed by another Nebula shortcut, it's refused outright — Nebula keeps your previous one rather than binding a key that quietly does nothing.

Mute microphone is the exception to "works from any app": Nebula only claims it while a call is live, so the combination stays free for everything else the rest of the time.

The menu bar icon

Nebula keeps an icon in your macOS menu bar — up at the top of the screen with your other menu extras — so it's reachable whether or not the main window is open. On Windows it's in the notification area at the bottom-right, and on Linux it's in whatever tray your desktop environment provides.

Clicking it opens a short menu:

ItemWhat it does
Open NebulaBrings the main window forward
Quick SendOpens the composer, same as the hotkey
SettingsA submenu — Open Settings… plus a jump straight to any one section
Check for updates…Always here; it becomes the download and restart control once an update is found
Quit NebulaActually exits — see below

The Settings submenu lists all five sections — General, Computer control, Workspaces, Capsule, Shortcuts — so you can land on the one you want instead of opening the window and hunting for it.

If Nebula loses its live connection, a Live updates disconnected line appears at the top of the menu so you know the counts have gone stale.

On macOS either mouse button opens the menu. On Windows a left-click jumps straight to Nebula and a right-click opens the menu instead.

What the icon is telling you

The icon itself carries state, so you can read it without clicking.

Nothing waiting.

Results you haven't read yet. On macOS the count sits next to the icon in the menu bar; on Windows and Linux it's in the tooltip.

An agent is paused waiting on an answer. This outranks unread — if something needs you, that's what the icon shows, however many unread results are stacked up behind it.

Closing versus quitting

Closing the window hides it — Nebula keeps running, agents keep working, and the Capsule stays on screen. Quitting is deliberate: the tray menu, Q, or the app menu.

On Linux this depends on your desktop environment running a tray host. Without one there's nowhere for the icon to live, so closing the window quits the app instead.

If you've granted Computer Control, quitting also stops agents from reaching your machine — Nebula asks first rather than letting a scheduled job fail quietly.

Thread windows

Any thread can be pulled into its own window, which is useful for watching a long-running job while you work in another channel. Opening the same thread again focuses the window you already have rather than making a second one.

Clicking a thread in the Capsule that belongs to a different workspace opens it this way too, so keeping an eye on one workspace doesn't drag your whole app out of another.

On this page