Desktop settings
The desktop app's own settings window — Computer Control, the Capsule, hotkeys, plus your workspace and account settings in the same place.
The desktop app has its own settings window, and it holds three groups: Workspace, Account, and Preferences. Preferences is the part that belongs to this computer — everything else follows your account the way it does on the web.
It's an ordinary resizable window, so you can leave it open beside Nebula while you change things. Every entry point can drop you straight onto the section you want.
⌘ , on macOS, the same as any Mac app. There's no equivalent hotkey on Windows or Linux — use the tray.
The gear icon on the Capsule opens this window on the Capsule section. The Capsule no longer keeps settings of its own.
Desktop app settings, at the bottom of the settings nav under This computer. It only appears when you're running the desktop app — in a browser there's nothing to open, so it's hidden.
What's in it
The Preferences group is the machine-scoped part.
Computer name — how this machine appears in Nebula. Leave it blank and it uses your computer's own hostname. Worth setting if you run Nebula on more than one machine and "MacBook-Pro-3" isn't telling you much.
Share anonymous usage data — on by default. Turning it off stops the desktop app and the Nebula app inside it from sending usage data.
Hardware acceleration — on by default, and it renders Nebula with your graphics card. Nebula turns this off by itself if your graphics driver crashes repeatedly, and tells you it has; switch it back on once you've updated the driver. Either way it takes effect the next time Nebula starts.
The theme used across every Nebula client. It's stored on your account rather than this machine, so picking one here changes what you see on the web and in the terminal too.
Three choices for how much access agents get: Allow using my computer (works even when Nebula is closed), Allow only while Nebula is open, or Don't allow. Pick either of the first two and you also get Access — Working folder only or Whole system — and a Primary folder to point them at.
Which of your workspaces may run work on this machine is decided here too, one toggle each — it used to be a section of its own.
This section also reports the helper's status and your Device ID, and View logs tails what it's been doing. See Computer Control for what each choice unlocks.
Everything about the Capsule — which corner it sits in, its size, which threads it follows, and per-workspace muting. Its gear icon brings you here rather than opening a menu of its own.
The first row is Notifications, and it's a three-way choice rather than an on/off switch: Capsule keeps the orb in the corner of your screen, System uses your computer's own notifications instead with no capsule, and Off turns both off. They're exclusive on purpose — a mention announced by a card in the corner and a banner from the OS is one message said twice. Capsule is the default.
Under System you also get What gets announced, one level each for Incoming calls, Alerts, Chats and finished tasks, and People coming online — Off, Quiet, or Pop up, listed loudest first. Presence never posts a system notification whatever you set it to. If your computer is blocking Nebula's notifications, a row here says so and offers to open your system settings.
The four global hotkeys — Summon Nebula, Quick send, QuickLive, and Mute microphone. Click one and press the combination you want. See Shortcuts & tray.
The folder agents work out of goes by two names. This window calls the row Primary folder but labels the narrow access mode Working folder only, and the command-line tool calls it Working folder throughout. It's one setting whichever name you meet it under — which is why running the CLI from another directory can repoint the folder you picked here — it asks first, unless that folder is one you've already approved there.
Workspace and Account, in the same window
The other two groups aren't machine settings — they're the same workspace and account settings you'd reach on the web, opened here so you don't have to switch surfaces.
| Workspace | Account | Preferences | |
|---|---|---|---|
| Scope | The workspace you're in | Your account, everywhere | This computer only |
| Holds | General, Members, API keys, Devices, Models, Notifications, Usage, Billing | Profile, Connections, Coding Harness, Advanced | General, Appearance, Computer control, Capsule, Shortcuts |
| Follows you to another machine | Yes | Yes | No |
API keys is worth knowing about by name: shared keys for apps Nebula already knows sit under Providers, and your own secrets under Variables, on one page. If you're looking for Connections or Secrets, this is where they went — they used to be two separate entries, and old links to either still land here.
Signing in on desktop also signs in the Nebula command-line tool on this machine — they share one credential. Signing out of one signs out the other.
Related
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.
Nebula on your phone
Install the Nebula mobile app, sign in with an email code, share things into a channel from any app, and know what works differently on a phone.