# Overview

The Foxora CLI is the agent terminal — a fast, native command-line client that runs the same crews of agents as the desktop app, straight from your shell. Type `foxora` to open the interactive UI, or drive it headlessly with commands such as `foxora run`, `foxora sessions`, and `foxora doctor`.

## What the CLI is

foxora is the command-line client for Foxora. On first run it provisions the Foxora Runtime (the agent engine, Memory Den, and a workspace) into a per-user cache and runs session data locally. Foxora-managed model calls route through the Foxora gateway; BYOK remains an optional agent-level model configuration.

Run with no arguments and it opens a full-screen terminal UI. Pass a subcommand and it runs headless, printing to stdout like any other CLI — perfect for scripts, CI, and quick one-shots.

## When to use it

- You live in the terminal — drive agents without leaving your shell.
- One-shot prompts — `foxora run "summarize this repo"` streams a reply and exits.
- Scripting & CI — the headless subcommands print plain text you can pipe.
- Headless boxes — no desktop app required; the CLI provisions its own runtime.

The CLI uses the same Foxora account as the other clients. On one computer,
Desktop and CLI share the device runtime and `~/.foxora` data home, including
local sessions and Memory Den. The web app uses its own cloud workspace; signing
in to the same account does not copy the device’s local sessions, files, or
memories into the browser.

> **This track targets v5.0.3** Commands, flags, and output shown here describe the foxora CLI as of v5.0.3. Check your version any time with `foxora --version`, and keep it current with `foxora update`.

## Core concepts

### Runtime

The engine + memory + workspace bundle the CLI installs into `~/.foxora/runtime`. `foxora setup` provisions it; `foxora doctor` tells you whether it’s healthy.

### Crew (tier)

A crew is a tier of agents — fast, pro, or max — that plan, act, and verify their own work. You can pick a tier per run; otherwise the CLI routes for you.

### Session

Each conversation is a session stored by the local Foxora runtime. Desktop and CLI connect to that same runtime on the device, so both can access its local sessions and Memory Den. This data does not automatically sync to the web app or another device. List the available local sessions with `foxora sessions`.