Command reference

Every nora command group at a glance.

Cheat-sheet index of every top-level command. Each group links to its detailed page.

Setup

Group	Purpose	Docs
auth	Sign in, switch workspaces, manage tokens.	Auth
--base-url, --workspace, --flow, --json	Global flags.	Global flags

Flows

Group	Purpose	Docs
flows	Flow CRUD, publish, rollback, versions.	Flows
flows settings	Flow-level settings (approvals webhook, defaults).	Flow settings
vars	Flow-level {{name}} variables.	Vars
schema	Print BuilderPayload schema.	Schema

Blocks

Group	Purpose	Docs
agents	Agent blocks — prompts, models, sources, memory.	Agents
tools	Tool blocks — HTTP/inline, params, headers.	Tools
actions	Action blocks — post-answer side effects.	Actions
triggers	Trigger blocks — API, webhook, schedule.	Triggers
edges	Wire and unwire blocks.	Edges

Data & knowledge

Group	Purpose	Docs
pipelines	Foundry pipelines — nodes, edges, schedule, runs, logs.	Pipelines
documents	Library documents — tag, supersede.	Documents
memory	Memory spaces — notes, nodes, edges, sessions.	Memory
retrieval	Search, presets, diagnose.	Retrieval
causal	Per-folder causal graphs (STAGED/LIVE).	Causal
connectors	Reusable external-system credentials.	Connectors

Reliability

Group	Purpose	Docs
traces	Inspect runs, trigger verifier.	Traces
feedback	Submit thumbs/corrections; describe external webhook.	Feedback
approvals	Decide gates; wire webhook.	Approvals

Workspace

Group	Purpose	Docs
providers	LLM provider API keys.	Providers
billing	Plan, usage, invoices, tax, overage cap.	Billing

Reference

Group	Purpose	Docs
Input modes	? prompt / - stdin / @file / literal.	Piping & secrets

Common shell patterns

Snapshot a Flow to git

nora flows snapshot support > flows/support.json
git add flows/support.json && git commit -m "sync support flow"

Bulk update every Agent in a Flow

for id in $(nora flows get support | jq -r '.blocks[] | select(.kind=="agent").id'); do
  nora agents update $id --set-max-cost 0.10
done

Publish gated on simulation

nora flows apply support flows/support.json
if nora providers check support --json | jq -e '.gaps | length > 0' > /dev/null; then
  echo "Missing provider keys"; exit 1
fi
nora flows publish support --summary "$(git log -1 --pretty=%s)"

Get help on any command

nora --help
nora agents --help
nora agents update --help

--help is context-aware — deeper commands show only their own flags.

Getting help

• Command doesn’t work as documented — run with --verbose for full HTTP tracing.
• Auth issues — nora auth status, then re-login or set NORA_TOKEN.
• Wrong workspace — nora --workspace <id> ... for one-off, or nora auth workspaces switch <id> to change default.
• Everything else — file an issue in the repo, or email [e-mail].

Install & upgrade

See Install.