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 |
status | Show CLI status overview |
chat | Send a message to an agent DM and stream the response |
call | Voice calls |
channels | Manage channels (threads) |
agents | Manage agents |
skills | Manage agent skills |
workspace | Manage workspaces — list, switch, create |
local-device | Manage computer control and the local device daemon |
devices | Manage your device |
services | Manage device services |
integrations | Connect and manage workspace integrations |
files | Manage files — upload, download |
billing | Manage billing and credits |
profile | View or update your user profile |
variables | Manage user variables |
capabilities | Probe and print this host's capability snapshot |
logs | Inspect Nebula log files on disk |
config | Manage CLI configuration |
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.
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.