Skip to main content
nubo is the Nubo command-line tool. Sign in once, then look at your projects, Frames, databases, volumes, and agents without leaving the terminal, either with quick ls commands or a full-screen interactive view. Today it’s read-only. It’s built for checking on things and for scripting (it can print raw JSON), not for deploying or editing. To deploy or change something, use the dashboard, a git push, or the API.

​
Install

curl -fsSL https://dl.withnubo.com/nubo-cli/install.sh | bash
That grabs the right nubo binary for your machine (macOS or Linux, Intel or ARM) and drops it on your PATH. A couple of knobs if you need them:
  • NUBO_VERSION=v0.1.0 pins a specific release instead of the latest.
  • NUBO_INSTALL_DIR=$HOME/.local/bin changes where the binary lands.

​
Sign in

nubo login                 # opens your browser and signs in with GitHub
nubo login --with-token    # paste a token instead of using the browser
nubo logout
nubo whoami                # shows who you're signed in as
nubo login opens your browser, you sign in with GitHub, and the CLI saves a long-lived token to ~/.config/nubo/credentials.json (readable only by you). From then on every command uses it.
Prefer not to use the browser, or on a headless box like a CI runner? Create a personal access token in the dashboard (Settings → Tokens & agents) and use nubo login --with-token, or pipe it in with nubo login --token-stdin. See API authentication for more on tokens.

​
Browse your stuff

Run nubo with no arguments to open the interactive view, or use the ls commands to print to the terminal: 
nubo                                          # launch the interactive view
nubo projects ls
nubo spaces ls   --project <project_id>
nubo frames ls   --project <project_id> --space <space_id>
nubo volumes ls  --project <project_id>
nubo agents ls
Add --json to any command to get the raw API response, which is handy for piping into jq or a script.

​
The interactive view

Running nubo on its own opens a clean, keyboard-driven view. Walk from projects into spaces into Frames, then open a Frame for a tabbed look at it:
  • Overview: status, what kind of Frame it is, its domains, and the latest deployment.
  • Logs: a live tail of the running Frame’s logs (press f to follow).
  • Metrics: CPU, memory, and network for the last 7 days, drawn inline.
Getting around:
KeyDoes
↑ ↓ or j kmove or scroll
Enter or lopen the selected item
Esc or hgo back
Tabswitch the Frame view
1 2 3jump to a Frame’s Overview / Logs / Metrics
ffollow logs
g / Gjump to top / bottom
rrefresh
/filter the list
?help
qquit

​
Configuration

By default the CLI talks to https://shuttle.withnubo.com using your saved login. You can override either one per command or with an environment variable:
SettingFlagEnvironment variableDefault
API URL--api-urlNUBO_API_URLhttps://shuttle.withnubo.com
Token--tokenNUBO_TOKENyour saved login

​
What it can’t do yet

This version is read-only on purpose. It can’t create, update, or delete anything, kick off deploys, run a shell, manage environment variables, or stream build logs. To deploy or change something, use the dashboard, a git push, or the API.

API authentication

Create the personal access token the CLI can sign in with

Frames

What the projects, spaces, and Frames you’re browsing actually are