> ## 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.

# Install the CLI

> Get the nora command on your machine and sign in.

The `nora` CLI lets you manage Flows, Agents, and integrations from your terminal. It's the same surface a coding agent uses through MCP.

## Install

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://install.nora.my | sh
    ```

    The script installs the `nora` binary to `~/.nora/bin` and prints instructions to add it to your `PATH`.
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew install nora-ai/tap/nora
    ```
  </Tab>

  <Tab title="From source (Rust)">
    ```bash theme={null}
    cargo install nora-cli
    ```
  </Tab>
</Tabs>

Verify:

```bash theme={null}
nora --version
```

## Sign in

```bash theme={null}
nora auth login
```

A browser window opens for OAuth. Sign in with the same account you use at [platform.nora.my](https://platform.nora.my). The CLI stores your credentials at:

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

## Check status

```bash theme={null}
nora auth status
```

Shows your active workspace, your saved workspaces, and a redacted token summary.

## Pick a workspace

If you belong to multiple workspaces, switch between them:

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

## Pin a Flow

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

```bash theme={null}
nora flows use <flow-slug>
```

Now `nora flows publish`, `nora agents list`, etc. all target 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`)      |

Or use the global flags: `--base-url`, `--workspace`, `--flow`.

## Next

<CardGroup cols={2}>
  <Card title="Auth commands" icon="key" href="/cli/auth">
    Manage tokens, workspaces, and sign-in.
  </Card>

  <Card title="Working with Flows" icon="diagram-project" href="/cli/flows">
    List, edit, publish, and roll back.
  </Card>
</CardGroup>