Skip to content

Environment variables

Variable Used by Meaning
PATCHULA_TOKEN lookup, run, apply, tui GitHub token; falls back to GITHUB_TOKEN, then GH_TOKEN, then gh auth token --hostname github.com
PATCHULA_LOG all log level: error, warn (the CLI default), info (the server default), debug or trace; -vv means debug
PATCHULA_RECHECK run, server now or next-run: when a ticked checkbox says it takes effect
PATCHULA_SETTINGS lookup, run, apply, tui, server the operator settings file
PATCHULA_TOOLS_DIR run, tools, server the tool store, holding the lockfile tools, the pinned mise that lists mise tools, and the mise packslip installs when there is none on PATH; default tools/ in the cache directory
DOTNET_SYSTEM_GLOBALIZATION_INVARIANT lockfiles passed on to dotnet restore, whose environment otherwise starts empty; the container image sets 1 because it has no ICU
XDG_CACHE_HOME local commands, server the user cache directory on Linux and other non-macOS systems, holding patchula/ (the server’s default is patchula/server); default ~/.cache. macOS uses ~/Library/Caches
PATCHULA_SERVER lookup, run, tui, auth the server URL for --remote, and for auth without --server
XDG_CONFIG_HOME lookup, run, apply, tui, auth where the default operator settings (patchula/settings.pkl), the server sign-ins (patchula/servers.json) and per-repository server choices (patchula/repositories.json) live; default ~/.config
PATCHULA_APP_ID server GitHub App ID
PATCHULA_APP_PRIVATE_KEY_FILE server path to the App’s PEM key
PATCHULA_APP_PRIVATE_KEY server the PEM itself, instead of a file
PATCHULA_WEBHOOK_SECRET_FILE server path to the webhook secret
PATCHULA_WEBHOOK_SECRET server the webhook secret itself, instead of a file
PATCHULA_SERVER_CACHE server the server’s cache and queue directory
PATCHULA_LISTEN server bind address; default 127.0.0.1:8080
PATCHULA_SHUTDOWN_TIMEOUT_SECS server drain deadline on SIGTERM, 1 to 3600; default 60
NO_COLOR all turns colour off: any value for --help, which prints as when it is piped; any non-empty value for reports, the spinner and errors, unless --color always forces it
CLICOLOR_FORCE --help any value but 0 colours help that is piped; NO_COLOR still wins
COLUMNS --help the width help wraps to; default the terminal’s, else 80
COLORTERM all truecolor or 24bit draws the Count’s colours exactly
TERM all without COLORTERM, a value containing 256color uses the nearest of 256 colours, and anything else the 16 ANSI colours; dumb hides the spinner

Flags override their environment variables. For each secret, set either the file or the value, not both.

Two more exist for development: PATCHULA_RECORD=1 records HTTP fixtures instead of replaying them, and PATCHULA_REDACT adds comma-separated literals for the fixture secret scanner to reject. See HTTP fixtures.