# CLI 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 headless with subcommands like run, sessions, and 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 everything locally — model calls route through the Foxora gateway, so no provider API keys ever live on your machine.

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 shares one account, one set of sessions, and one data home (~/.foxora) with Foxora Desktop and app.foxora.ai. Sign in once on any surface and the others follow.

> This track targets v5.0.3Commands, 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 in your data home and shared with every Foxora surface. List them with foxora sessions.