> ## Documentation Index > Fetch the complete documentation index at: https://www.edgee.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Edgee CLI > The fastest way to run Claude Code, Codex, OpenCode, Cursor, and VS Code Copilot through Edgee. One command to authenticate, launch, and compress. The Edgee CLI is the fastest way to route your coding agent through Edgee. Instead of manually configuring environment variables and API keys, the CLI handles authentication, session tracking, and launching your agent in a single command. ## Supported Tools Anthropic's official CLI for interactive coding with AI. OpenAI's CLI agent for software engineering tasks. Open-source coding agent with multi-model support. CLI coding agent, routed through Edgee. Charm's terminal coding agent, routed through Edgee. Terminal coding agent installed from npm, routed through Edgee. Moonshot AI's terminal coding agent, routed through Edgee. Kilo's terminal coding agent, routed through Edgee. Cursor IDE, routed through a local Edgee relay. Copilot in VS Code, routed through a local Edgee relay. CLI agents (Claude Code, Codex, OpenCode, CodeBuddy, Crush, Pi, Kimi Code, Kilo Code) run in your terminal. Cursor and VS Code Copilot are desktop editors: `edgee launch` starts a local Edgee relay and opens the editor routed through it. ## Installation ```bash theme={"dark"} curl -fsSL https://edgee.ai/install.sh | bash ``` ```bash theme={"dark"} brew install edgee-ai/tap/edgee ``` ```powershell theme={"dark"} irm https://edgee.ai/install.ps1 | iex ``` Verify the installation: ```bash theme={"dark"} edgee --version ``` ## Quick Start Launch your coding agent ```bash theme={"dark"} edgee launch claude ``` ```bash theme={"dark"} edgee launch codex ``` ```bash theme={"dark"} edgee launch opencode ``` ```bash theme={"dark"} edgee launch kilo ``` That's it. Your coding agent is now running with Edgee compression and observability enabled. After your session ends, the CLI prints a link to view your session analytics in the Edgee Console. ## Commands ### Anthentication commands #### `edgee auth login` Authenticate with Edgee for a specific provider. Opens a browser window for OAuth-based login. Your API key and credentials are saved to `~/.config/edgee/credentials.toml`. If you want to use multiple Edgee profiles, you can add `--profile ` to this command to declare the profile you want to use. ```bash theme={"dark"} edgee auth login ``` #### `edgee auth status` Display the current authentication status for all configured providers, including the logged-in email and connection mode. ```bash theme={"dark"} edgee auth status ``` #### `edgee auth list` List all configured profiles. Yes, because you can have multiple Edgee profiles, using `--profile ` when you log in. ```bash theme={"dark"} edgee auth list ``` #### `edgee auth switch` Switch to a different profile. ```bash theme={"dark"} edgee auth switch ``` ### Launch commands Launch your coding agent. ```bash theme={"dark"} edgee launch ``` #### `edgee launch claude` Launch Claude Code with all Edgee configuration automatically injected. The CLI sets the required environment variables (`ANTHROPIC_BASE_URL`, authentication headers, session ID) and starts Claude Code. ```bash theme={"dark"} edgee launch claude ``` You can pass any Claude Code arguments after the command: ```bash theme={"dark"} edgee launch claude "How do I implement a binary search?" edgee launch claude --resume ``` If you haven't authenticated yet, the CLI will prompt you to log in first. It will also ask you to select a connection mode on first launch: * **Claude Pro/Max**: uses your Anthropic subscription, Edgee compresses traffic to extend session duration * **API Billing**: uses Edgee API keys for direct billing, reducing token costs #### `edgee launch codex` Launch Codex with Edgee routing automatically configured. The CLI passes the required provider configuration to Codex and starts a new session. ```bash theme={"dark"} edgee launch codex ``` You can pass any Codex arguments after the command: ```bash theme={"dark"} edgee launch codex --model o4-mini ``` Connection modes for Codex: * **ChatGPT Plus/Pro**: uses your OpenAI subscription with Edgee compression * **API Billing**: uses Edgee API keys for direct billing #### `edgee launch opencode` Launch OpenCode with Edgee routing automatically configured. ```bash theme={"dark"} edgee launch opencode ``` The generated provider declares each model's context window and per-million-token rates from the Edgee catalog, so OpenCode's context gauge, auto-compaction, and session cost readout work instead of defaulting to zero. See [OpenCode](/docs/integrations/opencode) for the fields it writes. #### `edgee launch codebuddy` Launch CodeBuddy with Edgee routing automatically configured. ```bash theme={"dark"} edgee launch codebuddy ``` #### `edgee launch crush` Launch Charm's Crush with Edgee routing automatically configured. ```bash theme={"dark"} edgee launch crush ``` The generated provider declares each model's context window and per-million-token rates from the Edgee catalog, so Crush's context gauge, auto-summarizing, and session cost readout work instead of treating every model as unknown and free. See [Crush](/docs/integrations/crush) for the fields it writes. #### `edgee launch pi` Launch Pi with Edgee routing automatically configured. ```bash theme={"dark"} edgee launch pi ``` The CLI adds an `edgee` provider to `~/.pi/agent/models.json`, leaving your other providers and logins untouched, and keeps the API key out of the file. Requires Pi 0.79.4 or newer. See [Pi](/docs/integrations/pi). #### `edgee launch kimi` Launch Moonshot AI's Kimi Code with Edgee routing automatically configured. ```bash theme={"dark"} edgee launch kimi ``` The provider Edgee configures lives in memory for the length of the session — nothing is written to `~/.kimi-code/config.toml`. The session runs on Edgee credentials and the Edgee model catalog, not on a Moonshot subscription. Set `EDGEE_KIMI_MODEL` to pin a different catalog model. See [Kimi Code](/docs/integrations/kimi) for details. #### `edgee launch kilo` Launch the Kilo Code CLI with Edgee routing automatically configured. ```bash theme={"dark"} edgee launch kilo ``` The Edgee provider is passed to Kilo inline, so your own configuration is never read or modified and your API key is never written to disk. It declares each model's context window and per-million-token rates from the Edgee catalog, so Kilo's context gauge, auto-compaction, and session cost readout work instead of defaulting to zero. See [Kilo Code](/docs/integrations/kilo) for the fields it writes. #### Apps & editors Cursor and VS Code Copilot are desktop editors, not terminal CLIs. `edgee launch` authenticates, starts a **local Edgee relay**, and opens the editor routed through it, so its requests get compression and observability like any CLI agent. ```bash theme={"dark"} edgee launch cursor # Cursor IDE edgee launch copilot-vscode # GitHub Copilot in VS Code ``` Both require the target app to be installed. See the [Cursor](/docs/integrations/cursor) and [GitHub Copilot](/docs/integrations/copilot-vscode) integration pages for details. ### Other commands #### `edgee stats` Show the stats of your latest sessions. ```bash theme={"dark"} edgee stats ``` #### `edgee alias` Install launch aliases so you can start each tool by its own name instead of typing `edgee launch ` every time. ```bash theme={"dark"} edgee alias ``` What it installs: * **CLI agents** (`claude`, `codex`, `opencode`, `codebuddy`, `crush`, `pi`, `kimi`, `kilo`) — on macOS/Linux, PATH shims in `~/.edgee/bin`; on Windows, shell aliases. Running `claude` then transparently runs `edgee launch claude`. * **Desktop editors** (`cursor`, `copilot-vscode`) — a desktop wrapper (macOS `.app`, Linux `.desktop`, Windows Start Menu shortcut) that opens the editor through Edgee. Installed **only when the editor is already present**; otherwise skipped with a note. Scope it to one target, or undo: ```bash theme={"dark"} edgee alias cursor # only the Cursor wrapper edgee alias remove # remove every installed alias edgee alias remove claude # remove just one ``` After a fresh install on macOS/Linux, reopen your terminal (or run `exec $SHELL -l`) so `~/.edgee/bin` lands on your `PATH`. #### `edgee reset` Reset your credentials and connection mode for a provider. Useful if you need to switch accounts, change your connection mode, or re-authenticate. ```bash theme={"dark"} edgee reset ``` #### `edgee self-update` Check for updates and install the latest version of the Edgee CLI. ```bash theme={"dark"} edgee self-update ``` ## Configuration The CLI stores credentials in `~/.config/edgee/credentials.toml` with restricted file permissions (`600`). ```toml theme={"dark"} version = 2 [claude] api_key = "ek_..." email = "you@example.com" connection = "plan" # or "api" [codex] api_key = "ek_..." email = "you@example.com" connection = "plan" # or "api" ``` You don't need to edit this file manually. The CLI manages it through `edgee init`, `edgee auth login`, and `edgee reset`. ## Session Tracking Every `edgee launch` session is assigned a unique session ID. When the agent exits, the CLI prints a link to a detailed report in the Edgee Console. See [Sessions](/docs/features/sessions) for the full breakdown. ## How It Works When you run `edgee launch claude` or `edgee launch codex`, the CLI: 1. Verifies your authentication (prompts login if needed) 2. Generates a unique session ID 3. Configures the appropriate environment variables and headers 4. Launches the coding agent as a child process with Edgee routing enabled 5. Prints a session analytics URL when the session ends All requests from your coding session flow through Edgee's API, where token compression, cost tracking, and observability are applied automatically. ## Next Steps * Learn about [Token Compression V2](/docs/features/token-compression) and how it extends your sessions * Set up [alerts](/docs/features/alerts) to monitor your token spend * Explore [observability](/docs/features/observability) to track usage across all your sessions