CLI
Environment variables
Reference for environment variables that control Orca CLI behavior.
Environment variables that control the Orca CLI. Set them in your shell, or export them from your shell profile (~/.zshrc, ~/.bashrc) or CI environment.
| Variable | Description |
|---|---|
ORCA_API_KEY | API key (sk_live_… / sk_test_…) used in place of stored OAuth login. Equivalent to --api-key. |
ORCA_HOME_DIR | Directory the CLI uses for config.json and the host server tree. Default: ~/.orca. Shared with the desktop app. |
GH_TOKEN / GITHUB_TOKEN | Read by the gh CLI the host server shells out to for PR checkout and metadata. Set this for sandboxes or CI instead of running gh auth login interactively. |
The standalone install script also reads:
| Variable | Description |
|---|---|
ORCA_HOME | Install root for the standalone CLI and host binary. Default: ~/orca. |
ORCA_VERSION | Release tag to install. Default: latest, which resolves through the rolling cli-latest release. |