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 Profile timezone is unset and ANYY_TIMEZONE supplies no valid value
ANYY_OFFLINE	1, true, or yes prevents automatic download of missing managed rg/fd; existing binaries still work. It does not disable model, web-tool, MCP, or other network traffic

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

Variable	Value	Effect
NO_COLOR	any non-empty value	Disable colored CLI/setup output
FORCE_COLOR	any non-empty value	Force color over non-TTY, CI, and TERM=dumb; --no-color and NO_COLOR still win
TERM	dumb	Disable color by default and use ASCII symbols
CI	any non-empty value	Disable color by default; FORCE_COLOR can override
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.

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.

The configuration reference chooses the variable name. Exporting OPENAI_API_KEY, for example, does not automatically configure every provider. Set a supported credential_ref field to env:MY_MODEL_KEY and ensure the Gateway receives MY_MODEL_KEY. MCP configuration values use $NAME or ${NAME} to expand environment variables, with their own shell-expression rules; these differ from env:NAME credential references; see MCP values.

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
ANYY_LATEST_URL	<ANYY_RELEASE_BASE_URL>/latest	Version-marker URL used when VERSION is omitted

Examples:

curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.107 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

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
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.