# Command reference

The full command surface. Run foxora with no arguments to open the interactive UI; every subcommand below runs headless and prints to stdout. Use foxora --help for the same list in your terminal.

## Open the interactive UI

With no subcommand, foxora launches the full-screen agent terminal. Add --remote to attach to a running engine instead of spawning one.

```
foxora            # open the interactive UI
foxora --remote   # attach to a running engine, never spawn
```

## Set up & update

### foxora setup

Provisions the runtime (engine · memory · workspace · bun) into ~/.foxora.

```
foxora setup
```

### foxora update

Updates the CLI and keeps the runtime matched (channel-aware).

```
foxora update
```

## Account

### foxora login · logout

Sign in with the device-authorization flow, or clear local credentials.

```
foxora login
foxora logout
```

### foxora whoami

Show the signed-in account.

```
foxora whoami
# → ● signed in as you@example.com
```

## Run a prompt

### foxora run

One-shot: send a single prompt and stream the reply to stdout, then exit. Pass an optional crew tier (fast, pro, or max) first; the prompt can be positional or via -n / --prompt.

```
foxora run "summarize this repo"
foxora run fast -n "fix the failing test"
foxora run max --prompt "draft a migration plan"
```

## List your work

### foxora sessions · crews · agents

Headless lists of your sessions, crews, and agents.

```
foxora sessions   # list sessions
foxora crews      # list crews
foxora agents     # list agents
```

## Usage & models

### foxora usage

Your credit balance and the rolling weekly + monthly windows.

```
foxora usage
```

### foxora models

List the routable tiers / models available to your account.

```
foxora models
```

## Diagnose

### foxora doctor

Cross-OS diagnostics — checks platform, runtime, engine, account, and gateway in one pass. Run this first whenever something feels off.

```
foxora doctor
```

## Options & environment

Global flags work alongside any command:

```
-n, --prompt <text>   the prompt for `run`
--remote              attach to a running engine, never spawn
-h, --help            show help
-v, --version         print the version
```

And a few environment variables override the defaults:

```
FOXORA_ENGINE_URL     engine URL   (default http://127.0.0.1:4097)
FOXORA_GATEWAY_URL    gateway URL  (default https://api.foxora.ai)
FOXORA_RESOURCE_ID    memory bucket id (default cli:<user>)
```

> See it in your terminalfoxora --help prints the same command list, with examples, tinted to the brand palette. Trouble running anything? Start with foxora doctor, then the Troubleshooting guide.