# Command reference

Foxora CLI v5.0.3 supports the commands below. Run `foxora --help` on your installed version as the final authority.

## Commands

| Command | Purpose |
| --- | --- |
| `foxora` | Open the interactive terminal UI. |
| `foxora setup` | Set up the runtime: engine, Memory Den, and Bun. |
| `foxora update` | Update Foxora and its runtime to the latest release. |
| `foxora login` | Sign in through the browser. |
| `foxora logout` | Sign out. |
| `foxora run [crew] -n <message>` | Run one prompt, print the reply, and exit. |
| `foxora usage` | Show weekly and monthly credit usage. |
| `foxora doctor` | Diagnose the engine, runtime, and authentication. |
| `foxora models` | List available tiers and models. |
| `foxora whoami` | Show the signed-in account. |
| `foxora sessions` | List sessions. |
| `foxora crews` | List crews. |
| `foxora agents` | List agents. |
| `foxora --help` | Show command usage, options, and environment variables. |

## Options

| Option | Purpose |
| --- | --- |
| `-n, --prompt <text>` | Supply the prompt for `foxora run`. |
| `--remote` | Attach to a running engine without spawning one. |
| `-h, --help` | Show command help. |
| `-v, --version` | Print the installed CLI version. |

## Run examples

```bash
foxora run "summarize this repo"
foxora run fast -n "fix the failing test"
```

The optional crew argument accepts `fast`, `pro`, or `max`. If you omit it, Foxora chooses the default routing behavior.

> **Exact names matter:** The list commands are plural: `foxora sessions`, `foxora crews`, and `foxora agents`. Commands such as `foxora crew`, `foxora queue`, `foxora recall`, and `foxora org` are not part of v5.0.3.
