Environment Variables
Anyy prefers explicit CLI flags and validated Profile configuration. Environment variables are useful for process-level defaults, unattended installation, terminal compatibility, and credential references.
Profile and runtime resolution
| Variable | Effect |
|---|---|
ANYY_HOME | Select an explicit Anyy Home when no more specific command flag is supplied |
ANYY_DEFAULT_HOME | Change the base Home used by the Profile manager and named Profiles |
ANYY_TIMEZONE | Supply a portable IANA timezone when Profile configuration does not set one |
TZ | Host timezone fallback when neither Profile configuration nor ANYY_TIMEZONE supplies a valid value |
Precedence depends on the command, but an explicit --home or --profile selector is clearer than a hidden shell export. Run anyy config to see what actually resolved.
Combining named Profiles, --profile-root, command-specific --home, and environment overrides can make two terminals target different data. Choose one resolution strategy for normal operation.
Terminal presentation and compatibility
| Variable | Value | Effect |
|---|---|---|
NO_COLOR | any non-empty value | Disable colored CLI/setup output |
FORCE_COLOR | any non-empty value | Force color where the terminal is otherwise eligible |
TERM | dumb | Disable color/emoji features that require a capable terminal |
ANYY_TUI_SPLASH | 0 | Disable the TUI splash screen |
ANYY_TUI_BRACKETED_PASTE | off | Disable bracketed-paste mode for incompatible terminals |
ANYY_SKIP_VERSION_CHECK | any non-empty value | Skip the TUI's update-availability check |
--no-color is the preferred one-command override.
Managed browser executables
| Variable | Effect |
|---|---|
ANYY_CHROME_BIN | Provide the Chrome/Chromium executable path used by the managed browser backend |
ANYY_EDGE_BIN | Provide the Microsoft Edge executable path used by the managed browser backend |
Set these only when automatic executable discovery does not find the intended browser:
ANYY_CHROME_BIN=/opt/chrome/chrome anyy browser connect --browser chrome --headless --yes
The path must exist on the host running Anyy, not on a remote browser client.
GitHub Skill sources
| Variable | Effect |
|---|---|
GITHUB_TOKEN | Authenticate GitHub API requests used for Skill installation |
GH_TOKEN | Fallback when GITHUB_TOKEN is empty |
Use a narrowly scoped token. Do not put it in SKILL.md, prompts, shell history, or documentation examples.
Credential references
Supported configuration fields can refer to an environment variable with an env:NAME credential reference. The variable name is integration-specific; Anyy resolves it at runtime without copying the secret into config.yaml.
An environment reference is healthy only while the resident process actually receives that variable. A value exported in your interactive shell is not automatically present in a system service.
Installer variables
These variables apply to the native installation script:
| Variable | Default | Purpose |
|---|---|---|
ANYY_HOME | normal user: $HOME/.anyy; root: /root/.anyy | Choose the installation Home |
VERSION | latest published release | Pin an available release tag |
ANYY_INSTALL_COMPACT | 0 | Reduce retained rollback history when set to 1 |
ANYY_RELEASE_BASE_URL | https://anyy.ai/releases | Use a trusted compatible release mirror |
Examples:
curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.105 sh
curl -fsSL https://anyy.ai/install.sh | ANYY_INSTALL_COMPACT=1 sh
Use only a release mirror you control or have independently verified. The installer expects compatible binary and checksum endpoints.
Security guidance
- Prefer Anyy-managed secret storage for long-lived credentials.
- If you use an environment secret, make sure only the intended service/process inherits it.
- Never print the full environment in a support bundle or issue.
- Rotate a value at its provider when exposure is suspected.
- Use
anyy configto check reference health; it does not print secret values.
Troubleshooting
| Symptom | Check |
|---|---|
| Wrong Profile opens | Inspect ANYY_HOME, ANYY_DEFAULT_HOME, active Profile, and explicit flags |
| Schedule time is wrong | Set a valid IANA timezone in Profile configuration or ANYY_TIMEZONE |
| TUI paste behaves strangely | Try ANYY_TUI_BRACKETED_PASTE=off |
| Browser executable is missing | Set the correct ANYY_CHROME_BIN or ANYY_EDGE_BIN on the Anyy host |
env:NAME is unresolved in Gateway | Add the variable to the resident service environment, not only the login shell |
See Configuration for Profile settings and credential storage.