Global flags & env vars

Certain flags are available on every nora subcommand. Everything they do can also be set with an environment variable — pick whichever fits your workflow.

Global flags

Flag	Env var	Description
`--base-url <url>`	`NORA_BASE_URL`	Server origin. Default: `https://platform.nora.my`.
`--workspace <id>`	`NORA_TENANT`	Override active workspace for this command.
`--flow <slug>`	`NORA_FLOW`	Override active Flow for this command.
`--json`	—	Emit output as JSON (where the command supports formatting choice).
`--quiet` / `-q`	—	Suppress status output; only prints result.
`--verbose` / `-v`	`NORA_LOG=debug`	Show request/response tracing.
`-h`, `--help`	—	Print help for the current command.
`--version`	—	Print CLI version.

Precedence: flag > env var > active workspace/flow > CLI default.

Environment variables

Full list:

Variable	Purpose
`NORA_TOKEN`	Auth token (personal or workspace). Skips `auth login`.
`NORA_BASE_URL`	Server URL.
`NORA_TENANT`	Active workspace override.
`NORA_FLOW`	Active Flow override.
`NORA_CONFIG_DIR`	Config/credentials directory.
`NORA_LOG`	Log level: `error`, `warn`, `info`, `debug`, `trace`.
`NORA_NO_COLOR`	Set to any value to disable ANSI colors.
`EDITOR`	Editor used by `agents edit`, `tools edit`, etc.
`HTTPS_PROXY` / `HTTP_PROXY`	HTTP proxy for the CLI.

Precedence rules

Say you have:

NORA_TENANT=acme-prod in your shell.
nora auth workspaces current returns acme-dev.
You run nora --workspace acme-staging flows list.

The --workspace flag wins. This one command hits acme-staging. The env var and active workspace are unchanged. Same logic for --flow.

Getting help

--help is context-aware — the deeper you go, the more specific the help:

nora --help                # top-level commands
nora agents --help         # agents subcommands
nora agents update --help  # every flag on `agents update`

Version

nora --version

Prints CLI version, target platform, and the build’s commit hash. Include this when filing bug reports.

Output formats

Most commands support two output modes:

Human (default) — colored tables and structured text.
JSON (--json) — parseable, pipe-friendly. Same data, no formatting.

Use --json for anything you’re piping to jq, another CLI, or a script. Example:

nora flows list --json | jq -r '.[].slug'

Some commands emit JSON by default (flows get, flows snapshot, agents sources list) because their content isn’t easily tabulated.

Colors

Colors are on by default when the CLI detects a TTY. Turn off:

NORA_NO_COLOR=1 nora flows list

Or pipe to cat — colors auto-disable when output isn’t a TTY.

Debugging

If a command misbehaves, turn on verbose logging:

nora --verbose flows publish support-agent

Or:

NORA_LOG=debug nora flows publish support-agent

You’ll see the full HTTP request/response including headers (with token redacted). Good for reporting server-side issues.

Setup

Flows

Blocks

Data & knowledge

Reliability

Workspace

Reference

Global flags & env vars

Global flags

Environment variables

Precedence rules

Getting help

Version

Output formats

Colors

Debugging

​Global flags

​Environment variables

​Precedence rules

​Getting help

​Version

​Output formats

​Colors

​Debugging

Global flags

Environment variables

Precedence rules

Getting help

Version

Output formats

Colors

Debugging