Chatty DocumentationEnvironment variables
When to read this: Debug path/config issues or run Chatty in non-standard environments.
| Variable | Purpose | Default |
|---|---|---|
CHATTY_DATA_DIR | Override user data directory (AppImage) | Platform default |
CHATTY_DEBUG_UI | Enable chat view debug overlay | unset |
CHATTY_PDFIUM_LIB_DIR | Path to pdfium native library | auto-detect + cache |
CHATTY_ENABLE_DOC_RETRIEVER | Enable doc_retriever tool | unset = disabled |
CHATTY_SECRET_STORE | Where provider keys, MCP/A2A tokens and Hive tokens are kept (AGE-741): auto, keychain (refuse the file fallback), file (owner-only secrets.json in the config dir) | auto = OS keychain, else secrets.json with a warning |
CHATTY_INFER_MISSING_ANSWER | Headless: infer missing final answer | unset |
CHATTY_PROGRESS prefix | Sub-agent stderr progress lines | protocol constant |
XDG_RUNTIME_DIR | Required for GPUI on Linux/X11 | /tmp/... |
XDG_DATA_HOME | Linux data dir override | ~/.local/share |
GITHUB_TOKEN | Auto-updater GitHub API; REST fallback for the branch’s PR status when gh is unavailable | unset |
GH_TOKEN | Second choice after GITHUB_TOKEN for the PR-status REST fallback | unset |
OLLAMA_NUM_PARALLEL | Read for a loopback Ollama provider to size its delegation endpoint budget (AGE-305) | unset = default_endpoint_budget |
ECHO_PLUGIN_WASM | Tests: path to the echo plugin when it is not the staged fixture (AGE-176) | target/wasm-fixtures/echo/echo.wasm |
UPDATE_GOLDENS | Tests: rewrite the stream-fixture goldens instead of diffing them | unset |
APPIMAGE | AppImage self-update path | set by AppImage |
DISPLAY | X11 display for GPUI | :0 / :1 |
HOME | User home for paths | required |
PATH | Shell tool environment | inherited |
SHELL | Shell for subprocesses | /bin/bash |
PDFIUM_LIB_DIR | Compile-time pdfium path | build script |