> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/cli/auth)                 |
| `--base-url`, `--workspace`, `--flow`, `--json` | Global flags.                              | [Global flags](/cli/global-flags) |

## Flows

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

## Blocks

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

## Data & knowledge

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

## Reliability

| Group       | Purpose                                               | Docs                        |
| ----------- | ----------------------------------------------------- | --------------------------- |
| `traces`    | Inspect runs, trigger verifier.                       | [Traces](/cli/traces)       |
| `feedback`  | Submit thumbs/corrections; describe external webhook. | [Feedback](/cli/feedback)   |
| `approvals` | Decide gates; wire webhook.                           | [Approvals](/cli/approvals) |

## Workspace

| Group       | Purpose                                  | Docs                        |
| ----------- | ---------------------------------------- | --------------------------- |
| `providers` | LLM provider API keys.                   | [Providers](/cli/providers) |
| `billing`   | Plan, usage, invoices, tax, overage cap. | [Billing](/cli/billing)     |

## Reference

| Group       | Purpose                                     | Docs                                        |
| ----------- | ------------------------------------------- | ------------------------------------------- |
| Input modes | `?` prompt / `-` stdin / `@file` / literal. | [Piping & secrets](/cli/piping-and-secrets) |

## Common shell patterns

### Snapshot a Flow to git

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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 [support@conscience.technology](mailto:support@conscience.technology).

## Install & upgrade

See [Install](/cli/install).