Install the CLI

Get the nora command on your machine and sign in.

The nora CLI is a single binary that talks to the Nora platform over HTTPS. Every action you can take in the app has a CLI equivalent — see the Command reference for the full surface.

Install

macOS / Linux

curl -fsSL https://install.nora.my | sh

Installs the nora binary to ~/.nora/bin and prints instructions to add it to your PATH.

To pin a specific version:

curl -fsSL https://install.nora.my | NORA_VERSION=1.4.2 sh

Homebrew

brew install nora-ai/tap/nora

Auto-upgrades with brew upgrade nora.

From source (Rust)

cargo install nora-cli

Requires a recent stable Rust toolchain. Produces a locally-built binary in ~/.cargo/bin.

Docker

docker run --rm -it -v ~/.nora:/root/.nora nora-ai/cli:latest nora --help

Alias for convenience:

alias nora='docker run --rm -it -v ~/.nora:/root/.nora nora-ai/cli:latest nora'

Good when you can’t install a binary directly (locked-down laptops, ephemeral CI).

Verify:

nora --version

Upgrade

Install script

Re-run the install script — it fetches the latest.

curl -fsSL https://install.nora.my | sh

Homebrew

brew upgrade nora

Cargo

cargo install nora-cli --force

CLI check on start-up: if a newer version is available and your version is > 30 days old, you’ll see a one-line reminder. Turn off with NORA_NO_UPDATE_CHECK=1.

Sign in

nora auth login

A browser window opens for OAuth. Sign in with the same account you use at platform.nora.my.

For CI or headless environments, skip the browser flow with a token — see nora auth.

Credentials are stored at:

• macOS: ~/Library/Application Support/nora/credentials.json
• Linux: ~/.config/nora/credentials.json
• Windows: %APPDATA%\nora\credentials.json

File permissions are 0600 (read-only for you). Never commit it.

Check status

nora auth status

Shows your active workspace, your saved workspaces, and a redacted token summary. Always safe to run — no side effects.

Pick a workspace

If you belong to multiple workspaces, switch between them:

nora auth workspaces list
nora auth workspaces switch <workspace-id>

The switch is persistent — subsequent commands act on the newly active workspace until you switch again.

Override for one command without switching:

nora --workspace <other-id> flows list

Pin a Flow

Most commands operate on one Flow. Pin your working Flow so you don’t type the slug every time:

nora flows use <flow-slug>
nora flows current   # prints the pinned slug

Now nora flows publish, nora agents create, etc. all default to that Flow.

Environment overrides

For scripts and CI, override without touching stored config:

Variable	What it does
NORA_BASE_URL	Server origin (default https://platform.nora.my)
NORA_TENANT	Workspace override
NORA_FLOW	Flow override
NORA_TOKEN	Non-interactive auth (skip nora auth login)
NORA_CONFIG_DIR	Alternative config directory (for multi-account)
NORA_LOG	Log level: error / warn / info / debug / trace

Full list and precedence rules: Global flags.

Shell completion

Generate completion scripts for your shell:

# bash
nora completion bash > /etc/bash_completion.d/nora

# zsh
nora completion zsh > "${fpath[1]}/_nora"

# fish
nora completion fish > ~/.config/fish/completions/nora.fish

Restart your shell (or source the file).

Tab-completes subcommands and flags. Doesn’t fetch remote data (Flow slugs, IDs) — those require an extra round-trip; use --json | jq when you need them.

What to explore next

Auth commands

Sign in, switch workspaces, use tokens in CI.

Working with Flows

List, apply, publish, and roll back.

Full command reference

Every command group at a glance.

Piping & secrets

Feed secret values and files safely.