Edgee CLI
Launch agents, manage your login and organization, configure settings, and inspect usage.
The CLI signs you in to Edgee and launches your agent through the gateway. Start with the agent quickstart for installation and your first verified session.
Choose a task
| I want to… | Command or guide |
|---|---|
| Launch an agent | edgee launch claude, edgee launch codex, or another target below |
| Check my account | edgee auth status |
| Change organization or profile | Authentication and profiles |
| Change compression or routing | edgee settings or edgee settings claude |
| Read recent usage | edgee stats |
| See assigned plugins | edgee plugins |
| Show usage inside Claude Code | Statusline |
| Launch without typing Edgee each time | Aliases |
| Update Edgee | edgee update (edgee self-update is an alias) |
| Diagnose a problem | Troubleshooting |
Launch an agent
edgee launch claude
edgee launch codex
edgee launch opencode
Always give launch a target. Run edgee launch --help to see the targets supported by your installed version.
| Target | Application |
|---|---|
claude | Claude Code |
codex | Codex CLI |
opencode | OpenCode |
codebuddy | CodeBuddy |
crush | Crush |
pi | Pi |
kimi | Kimi Code |
kilo | Kilo Code CLI |
cursor | Cursor editor |
copilot-vscode | GitHub Copilot in VS Code |
omp | Oh My Pi |
copilot-cli | GitHub Copilot CLI |
intellij | GitHub Copilot in IntelliJ IDEA Beta |
copilot-desktop | GitHub Copilot Desktop Beta |
claude-desktop | Claude Desktop Beta |
codex-desktop | Codex Desktop Beta |
For additional targets, OS requirements, and release availability, see apps and additional agents.
Everything after the target is passed to the agent:
edgee launch claude --resume
edgee launch codex --help
Edgee's profile flag goes before the subcommand. Agent flags go after the target:
edgee -p work launch claude --resume
The CLI can prompt for login and connection mode on first launch. After a session with model traffic, it prints a report link. See Sessions.
Change agent settings
edgee settings
edgee settings claude
Choose the agent, then follow the menu to change its available compression and routing settings. These are settings for the selected organization's agent key, not a separate local routing policy.
Organization and squad rules can lock a setting. If an option cannot be changed, check Gateway settings and inheritance instead of repeatedly saving a local change.
Verify: launch a fresh request and inspect it in Logs. Changing a setting does not rewrite past sessions.
Inspect usage
edgee stats
edgee stats --limit 5
edgee stats --json --period 7d
edgee stats --json --local
The human-readable report uses stored session reports. JSON output can retrieve your usage from the API when signed in; --local uses this machine's stored reports. Inspect the JSON source field before comparing results across devices. edgee report is an alias for edgee stats.
Update and reconnect
edgee --version
edgee update
If you installed with Homebrew, you can use brew upgrade edgee-ai/tap/edgee. Builds without the self-update feature may not expose update.
Use edgee auth login to sign in again. edgee reset restarts the login flow; it is not the command to uninstall aliases. Use edgee auth logout to clear the active profile's login, and alias removal to restore ordinary agent launch commands.
Configuration and help
The CLI manages profiles in ~/.config/edgee/credentials.toml. The file contains credentials: do not paste it into an issue or commit it. Prefer CLI commands to manual edits.
edgee --help
edgee auth --help
edgee settings --help
edgee plugins --help
See configuration for environment overrides and self-hosted gateways, and plugins for centrally assigned skills and tools.