Nebula CLI
Run Nebula from your terminal. Install the nebula-ai CLI, sign in once, and use the full-screen app to chat, join calls, and drive your workspace.
nebula-ai puts your whole workspace in the terminal — the same agents, channels, threads and calls you get in the browser, without leaving your shell. Run it with no arguments for a full-screen app, or with a command to do one thing and exit.
Install it
npx nebula-aiThe first run downloads the binary for your platform, verifies it, and caches it. After that it starts instantly.
brew install agent-labs-dev/nebula/nebula-aiInstalls nebula-ai onto your PATH so you can run it from anywhere.
Sign in
Run nebula-ai login. It uses device-flow pairing, so the terminal shows you a code and hands off to your browser.
Approve it in the browser with the same account you use on the web.
You're done. Run nebula-ai on its own to open the app, or go straight to a command.
Unlike the desktop app, the CLI does not renew its pairing on its own. When a code expires it tells you to run nebula-ai login again — that's expected, not a fault.
Two ways to run it
| The full-screen app | One-off commands | |
|---|---|---|
| How | nebula-ai | nebula-ai <command> |
| Best for | Working in Nebula for a while | Scripts, CI, a quick question |
| Machine-readable | — | yes, with --json |
| Interactive | Yes | only where the command asks |
Anything with no arguments opens the app; anything with arguments runs and exits. See the command reference for the full list.
Getting around the app
The app is keyboard-driven and has two modes, like a modal editor. In navigation mode the keys move you around; press i to start typing and Esc to come back out.
| Key | What it does |
|---|---|
| ? | Opens the shortcuts help — the full list, always current |
| Ctrl K | Search across your workspace |
| j / k | Move down / up |
| Enter | Open the selected item |
| Esc | Go back, or leave typing mode |
| @ / # | Jump to Agents / Channels |
| q | Quit |
Don't memorise these — ? lists every shortcut for the screen you're on, including ones this page doesn't cover.
Tabs
The app keeps tabs, the same way the web app does. 1–9 jump to a tab, h and l step between them, and x closes the current one. Home can't be closed.
Slash commands
Typing / in the composer opens the same slash commands you get on the web — Tab completes a name, Enter runs it. Pressing c on a message that mentions a command explains it instead of running it.
Picking a workspace
Your session has an active workspace, and every command uses it unless you say otherwise.
nebula-ai workspace switch <id-or-slug> changes the active workspace for everything that follows.
The global --workspace flag overrides it for a single command, which is what you want in a script.
nebula-ai workspace list prints them all; nebula-ai status shows who you're signed in as and where you're pointed.
What it can't do
The CLI drives the same backend as everything else, so the gaps are narrow and deliberate. The one you'll hit in practice is that actions needing a choice — picking a channel or a workspace from a list, renaming a connection — are refused with a note to use the web app instead. Everything else in nebula-ai integrations works from the terminal.
Stuck? Ask Nebula in any conversation — it can explain commands and set things up for you. For bugs or anything unresolved, email support@nebula.gg.
Related
Desktop settings
Settings that belong to this computer — its name in Nebula, Computer Control, which workspaces it serves, the Capsule, and your keyboard shortcuts.
Computer control from the CLI
Turn any machine into a Nebula local device with one command — set the working folder, choose whether agents can run commands, and manage the daemon.