Configuration
agentty is configured through flags, environment variables, and two on-disk paths. There is no sprawling config file to learn.
Environment variables
| Variable | Effect |
|---|---|
ANTHROPIC_API_KEY | API key used when no -k flag is passed. Second-highest priority. |
CLAUDE_CODE_OAUTH_TOKEN | OAuth token from the env, below API key but above on-disk creds. |
AGENTTY_SOCKS_PROXY | Route all TCP through this SOCKS5 proxy (set automatically by airgap mode). |
AGENTTY_AIRGAP_SSH | Extra flags injected into the ssh invocation for airgap. |
AGENTTY_INSECURE | Set to 1 to skip TLS peer verification. Last-resort only — never ship it. |
On-disk paths
~/.config/agentty/credentials.json— auth token, mode0600.~/.agentty/threads/<workspace-hash>/— one JSON file per thread.
Choosing a workspace
By default the launch directory is the workspace. Override without cd:
agentty --workspace ~/code/other-project
agentty --workspace / # opt out of the boundary entirelyTLS trust store
agentty picks up the system trust store at startup. Behind a TLS-terminating corporate proxy, install the proxy's CA into the system store (update-ca-certificates / update-ca-trust). See Corporate Proxies.