Docs · Reference
Environment variables
Every VINOS_* variable read by the shipped scripts, its default, and what changes when you set it.
All variables are optional — the shipped defaults work. Set any of
these in ~/.zshrc, ~/.bashrc, or a systemd Environment= line to
override.
Routing + AI
| Variable | Default | Effect |
|---|---|---|
ANTHROPIC_API_KEY | unset | Preferred key source. Overrides ~/.vinos/secrets/anthropic-key. |
VINOS_ROUTE | auto | auto (80/20 router) · anthropic · ollama. |
VINOS_AI_DEFAULT_MODEL | llama3.2 | Default Ollama model for vinos-ai chat. |
VINOS_AI_ANTHROPIC_MODEL | claude-sonnet-4-6 | Default Claude model when routed to anthropic. |
OLLAMA_HOST | http://localhost:11434 | Point at a remote Ollama if you have one. |
Routines
| Variable | Default | Effect |
|---|---|---|
VINOS_ROUTINES_USER | ~/.vinos/routines | User-scoped routine dir. |
VINOS_ROUTINES_SYS | /etc/vinos/routines | System-scoped routine dir (shipped starters). |
VINOS_ROUTINES_STATE | ~/.vinos/routines/state | Output + ledger location. |
VINOS_ROUTINE_DEBUG | unset | Set to 1 to print every bwrap invocation before it runs. |
VINOS_ROUTINE_SHELL_TIMEOUT | 30 | Fallback shell-tool timeout in seconds. |
VINOS_ROUTINE_MAX_TOKENS | 20000 | Fallback per-run token cap (routines override in their TOML). |
Founder utilities
| Variable | Default | Effect |
|---|---|---|
VINOS_CODE_DIR | ~/code/* | Where vinos-standup looks for git repos. |
VINOS_STANDUP_WINDOW | yesterday | Default window: yesterday / week / since:YYYY-MM-DD. |
VINOS_FOCUS_STATE | ~/.vinos/focus/current | Where the focus session state file lives. |
VINOS_COMMIT_KIND | unset | Default conventional prefix bias for vinos-commit. |
Theme + display
| Variable | Default | Effect |
|---|---|---|
VINOS_THEME_DIR | /usr/share/vinos/themes | Base directory for theme lookup. |
VINOS_ACTIVE_THEME | (read from ~/.config/vinos/active-theme) | Force a specific theme for one process. |
HYPR_CONF | ~/.config/hypr/hyprland.conf | Where vinos-cheatsheet looks for keybindings. |
Paths + secrets
| Variable | Default | Effect |
|---|---|---|
VINOS_SECRETS_DIR | ~/.vinos/secrets | Where the runtime looks for API-key files. |
VINOS_CACHE_DIR | ~/.cache/vinos | Cache dir for hint data + walker warm-ups. |
EDITOR | nvim | Used by vinos-routine edit, vinos-launch-editor. |
TERMINAL | foot | Preferred terminal emulator for the vinos-launch-* family. |
systemd unit environment
Systemd user units generated by vinos-routine enable <name> inherit
ANTHROPIC_API_KEY, VINOS_ROUTE, OLLAMA_HOST, VINOS_AI_DEFAULT_MODEL,
and VINOS_ROUTINE_DEBUG from ~/.config/environment.d/*.conf. Drop
system-wide values there so cron-like runs pick them up:
$ cat ~/.config/environment.d/vinos.conf
VINOS_ROUTE=auto
VINOS_AI_DEFAULT_MODEL=qwen2.5:7b
Reload after edits:
$ systemctl --user daemon-reload