Command reference
Every nebula-ai command in one table, plus the global flags, JSON output for scripting, shell completion, and where to find the logs.
Every nebula-ai command, what it does, and the flags that apply everywhere. Run nebula-ai <command> --help for the options on any one of them — that output is generated from the binary you have, so it's always current.
Commands
| Command | What it does |
|---|---|
login | Authenticate with Nebula via device-flow pairing |
logout | Clear stored credentials |
status | Show CLI status overview |
usage | Show workspace token usage and cost |
chat | Send a message to an agent DM and stream the response |
call | Voice calls |
channels | Manage channels (threads) |
agents | Manage agents — including agents skills |
workspace | Manage workspaces — list, switch, create |
integrations | Connect and manage workspace integrations |
user | Your profile and account settings — see below |
profile | Your public profile — get, set, set-email, verify-email, upload-avatar |
local-device | Manage computer control and the local device daemon |
install | Set up computer control — an alias of local-device enable |
uninstall | Turn off computer control, stop the daemon, and remove this device |
capabilities | Probe and print this host's capability snapshot |
logs | Inspect Nebula log files on disk |
update | Check for a newer CLI version and install it |
completion | Generate a shell completion script |
Run nebula-ai with no command at all to open the full-screen app.
Account commands live under user
Anything that belongs to your account rather than the workspace is nested one
level down, so nebula-ai user on its own prints a summary of who you're
signed in as.
| Command | What it does |
|---|---|
user update | Update your username or display name |
user variables | Manage user variables |
user config | Manage CLI configuration |
user devices | Manage your devices — user devices services covers device services |
user billing | Manage billing and credits |
user files | Manage files — upload, download |
Changing your email address
Your email is the one profile field you can't set outright — changing it takes proof that you can receive mail at the new address, so it runs in two steps.
Run nebula-ai profile set-email <address>. Nebula mails a six-digit code
to the new address and tells you your current address hasn't changed yet.
Run nebula-ai profile verify-email <code> with the code from that mail.
Only then does the address actually change.
Codes expire after 15 minutes; request another with set-email if yours runs
out. nebula-ai profile get marks an address that hasn't been confirmed yet
with (unverified).
nebula-ai profile set --email no longer works and will tell you so. Use the
two commands above instead.
Global flags
These work on every command.
| Flag | What it does |
|---|---|
--json | Output raw JSON |
--workspace <id> | Run against a specific workspace, ignoring the active one |
-v, --verbose | Verbose output — the same as --log-level=debug |
--log-level <level> | One of error, warn, info, debug, trace |
--no-color | Disable colours |
--api-url <url> | Point at a different API host |
Scripting
--json turns any command into something you can pipe. It's a global flag, so it works the same everywhere.
Combine --json with --workspace in CI so a script never depends on whichever workspace happened to be active on that machine.
Shell completion
nebula-ai completion prints a completion script for bash, zsh, or fish — source it from your shell profile.
When something goes wrong
nebula-ai status shows whether you're signed in and which workspace you're pointed at — most surprises are one of those two. nebula-ai capabilities reports what this machine supports, like whether ffmpeg is available for camera.
nebula-ai logs inspects the log files, and nebula-ai logs path prints where they live (~/.nebula/logs/). Re-run a failing command with -v for the detail.
nebula-ai update checks for a newer version and installs it. Worth trying before reporting anything.
Still stuck? Ask Nebula directly — it's good at drafting a support email with the right detail in it. For bugs or anything unresolved, email support@nebula.gg.
Related
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.
Calls from the terminal
Start, join, and run Nebula live calls from your shell. Chat-first by default, with voice as a two-step opt-in and a headless mode for servers.