Skip to main content
This page documents environment variables used by the current CLI implementation.

Config and permissions

  • ZEROXZERO_CONFIG: absolute path to a config file to merge
  • ZEROXZERO_CONFIG_DIR: directory to load as an extra .zeroxzero source
  • ZEROXZERO_CONFIG_CONTENT: inline JSON config to merge at high precedence
  • ZEROXZERO_DISABLE_PROJECT_CONFIG: disable project config discovery
  • ZEROXZERO_PERMISSION: inline JSON permission overrides

Session and sharing

  • ZEROXZERO_AUTO_SHARE: auto-share sessions where supported
  • ZEROXZERO_DISABLE_AUTOCOMPACT: disable auto compaction
  • ZEROXZERO_DISABLE_PRUNE: disable prune in compaction flow

Server and auth

  • ZEROXZERO_SERVER_USERNAME: basic auth username for server connections
  • ZEROXZERO_SERVER_PASSWORD: basic auth password for server connections

Installation and behavior toggles

  • ZEROXZERO_DISABLE_AUTOUPDATE: disable update checks
  • ZEROXZERO_DISABLE_TERMINAL_TITLE: disable terminal title updates
  • ZEROXZERO_GIT_BASH_PATH: explicit Git Bash path for Windows pager/interop
  • ZEROXZERO_DISABLE_DEFAULT_PLUGINS: disable bundled default plugins
  • ZEROXZERO_DISABLE_LSP_DOWNLOAD: disable automatic LSP binary download
  • ZEROXZERO_DISABLE_MODELS_FETCH: disable models fetch
  • ZEROXZERO_ENABLE_EXPERIMENTAL_MODELS: include experimental models

Skills and provider toggles

  • ZEROXZERO_DISABLE_CLAUDE_CODE
  • ZEROXZERO_DISABLE_CLAUDE_CODE_PROMPT
  • ZEROXZERO_DISABLE_CLAUDE_CODE_SKILLS
  • ZEROXZERO_DISABLE_EXTERNAL_SKILLS
  • ZEROXZERO_MODELS_URL
  • ZEROXZERO_MODELS_PATH

Experimental flags

  • ZEROXZERO_EXPERIMENTAL
  • ZEROXZERO_EXPERIMENTAL_FILEWATCHER
  • ZEROXZERO_EXPERIMENTAL_DISABLE_FILEWATCHER
  • ZEROXZERO_EXPERIMENTAL_ICON_DISCOVERY
  • ZEROXZERO_EXPERIMENTAL_DISABLE_COPY_ON_SELECT
  • ZEROXZERO_EXPERIMENTAL_EXA
  • ZEROXZERO_ENABLE_EXA
  • ZEROXZERO_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS
  • ZEROXZERO_EXPERIMENTAL_OUTPUT_TOKEN_MAX
  • ZEROXZERO_EXPERIMENTAL_OXFMT
  • ZEROXZERO_EXPERIMENTAL_LSP_TY
  • ZEROXZERO_EXPERIMENTAL_LSP_TOOL
  • ZEROXZERO_DISABLE_FILETIME_CHECK
  • ZEROXZERO_EXPERIMENTAL_MARKDOWN

Notes

  • Truthy boolean vars accept true or 1.
  • Some values are read dynamically at access time (ZEROXZERO_CONFIG_DIR, ZEROXZERO_DISABLE_PROJECT_CONFIG).
  • For config precedence details, see Complete CLI Guide.