Skip to main content

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

VariableEffect
ANYY_HOMESelect an explicit Anyy Home when no more specific command flag is supplied
ANYY_DEFAULT_HOMEChange the base Home used by the Profile manager and named Profiles
ANYY_TIMEZONESupply a portable IANA timezone when Profile configuration does not set one
TZHost 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.

Do not mix selectors casually

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

VariableValueEffect
NO_COLORany non-empty valueDisable colored CLI/setup output
FORCE_COLORany non-empty valueForce color where the terminal is otherwise eligible
TERMdumbDisable color/emoji features that require a capable terminal
ANYY_TUI_SPLASH0Disable the TUI splash screen
ANYY_TUI_BRACKETED_PASTEoffDisable bracketed-paste mode for incompatible terminals
ANYY_SKIP_VERSION_CHECKany non-empty valueSkip the TUI's update-availability check

--no-color is the preferred one-command override.

Managed browser executables

VariableEffect
ANYY_CHROME_BINProvide the Chrome/Chromium executable path used by the managed browser backend
ANYY_EDGE_BINProvide 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

VariableEffect
GITHUB_TOKENAuthenticate GitHub API requests used for Skill installation
GH_TOKENFallback 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:

VariableDefaultPurpose
ANYY_HOMEnormal user: $HOME/.anyy; root: /root/.anyyChoose the installation Home
VERSIONlatest published releasePin an available release tag
ANYY_INSTALL_COMPACT0Reduce retained rollback history when set to 1
ANYY_RELEASE_BASE_URLhttps://anyy.ai/releasesUse 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 config to check reference health; it does not print secret values.

Troubleshooting

SymptomCheck
Wrong Profile opensInspect ANYY_HOME, ANYY_DEFAULT_HOME, active Profile, and explicit flags
Schedule time is wrongSet a valid IANA timezone in Profile configuration or ANYY_TIMEZONE
TUI paste behaves strangelyTry ANYY_TUI_BRACKETED_PASTE=off
Browser executable is missingSet the correct ANYY_CHROME_BIN or ANYY_EDGE_BIN on the Anyy host
env:NAME is unresolved in GatewayAdd the variable to the resident service environment, not only the login shell

See Configuration for Profile settings and credential storage.