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.

VariableDescription
ORCA_API_KEYAPI key (sk_live_… / sk_test_…) used in place of stored OAuth login. Equivalent to --api-key.
ORCA_HOME_DIRDirectory the CLI uses for config.json and the host server tree. Default: ~/.orca. Shared with the desktop app.
GH_TOKEN / GITHUB_TOKENRead 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:

VariableDescription
ORCA_HOMEInstall root for the standalone CLI and host binary. Default: ~/orca.
ORCA_VERSIONRelease tag to install. Default: latest, which resolves through the rolling cli-latest release.

On this page

No Headings