Settings Generator

Configure `~/.afk/` without reading the docs.

Pick what you need. Copy the output. Paste it once.

Your input never leaves your browser. No analytics, no telemetry, and zero third-party scripts — the generator runs entirely client-side and makes no network requests. Verify it yourself: open DevTools → Network and reload.

Quick setup — covers 80% of installs

I want to run AFK with using .My ANTHROPIC_API_KEY:

Add what you need

Send me Telegram notifications— Push agent output to your phone

Run a daemon for scheduled tasks— Cron-driven background agent

Use a custom system prompt— Override the default agent instructions

Enable auto-routing— Skip prompts when AFK can decide which agent to use

Fine-tune model behavior— Tokens, temperature, budget, thinking

Show all 74 optionsEvery env var + JSON field, by category — skip anything you don't need

Model & Sampling

AFK_MODEL→ afk.env

Default model for agent turns. Accepts short aliases (opus, sonnet, haiku, sonnet_1m, opus_1m) or full model IDs like claude-opus-4-5.

AFK_MAX_TOKENS→ afk.env

Cap on total tokens per turn (input + output). Default 4096.

AFK_TEMPERATURE→ afk.env

Numeric temperature override for model sampling. Leave blank to use provider default.

AFK_THINKING→ afk.env

Extended-thinking mode. Accepts adaptive | disabled | enabled:<N> | enabled:max. Defaults to the model-appropriate mode (adaptive on current models) when unset.

AFK_MAX_BUDGET_USD→ afk.env

Per-turn USD budget ceiling. Aborts when projected spend would exceed this. Default $5.00.

Advanced options

AFK_TASK_BUDGET→ afk.env

Per-task token budget ceiling. Aborts when cumulative usage would exceed it. Default 100 000.

AFK_MAX_OUTPUT_TOKENS→ afk.env

Cap on output tokens per turn only (not input). Falls back to provider default when unset.

AFK_DEFAULT_SUBAGENT_MODEL→ afk.env

Override the default model used when a subagent is dispatched without an explicit model.

AFK_COMPACT_MODEL→ afk.env

Override the model used by the /compact summarizer. Falls back to a cheap haiku-class model when unset.

AFK_COMPACT_KEEP_LAST_TURNS→ afk.env

Number of recent turns the compactor keeps verbatim during /compact.

AFK_TIMEOUT_MS→ afk.env

Per-turn timeout in milliseconds. Provider/SDK default when unset.

AFK_PROMPT_CACHE_TTL→ afk.env

TTL for Anthropic prompt-cache blocks. Accepts 5m or 1h.

AFK_DISABLE_PROMPT_CACHE→ afk.env

Disable Anthropic prompt caching when set to 1/true/yes/on. Unset = caching enabled (default).

Provider & Endpoints

AFK_PROVIDER→ afk.env

Force provider selection. Overrides the model-name heuristic. The --provider CLI flag wins when both are set.

AFK_EFFORT→ afk.env

Effort hint guiding adaptive-thinking depth, forwarded as Anthropic output_config.effort (model-gated; ignored where unsupported). Accepts low | medium | high | xhigh | max.

AFK_LOCAL_BASE_URL→ afk.env

Base URL for a self-hosted Anthropic-compatible server (e.g. vllm-mlx). When set, traffic is routed away from api.anthropic.com.

AFK_LOCAL_API_KEY→ afk.envsecret

Placeholder API key for local Anthropic-compatible servers. Set when AFK_LOCAL_BASE_URL is configured. Default "local".

AFK_OPENAI_BASE_URL→ afk.env

Base URL override for the OpenAI-compatible provider. Used for local shims (Ollama, vLLM, LM Studio, mlx_lm.server). Do not include a trailing /chat/completions — the SDK appends it automatically.

API Keys

ANTHROPIC_API_KEY→ afk.envsecret

Anthropic API key. Tier-1 credential — overrides keychain OAuth and CLAUDE_CODE_OAUTH_TOKEN.

OPENAI_API_KEY→ afk.envsecret

OpenAI API key for the openai-compatible provider (gpt-*, o1*, o3*, o4* models).

CODEX_API_KEY→ afk.envsecret

Fallback OpenAI API key for the openai-compatible provider, read after OPENAI_API_KEY. Legacy name from the removed @openai/codex-sdk integration — prefer OPENAI_API_KEY.

BRAVE_SEARCH_API_KEY→ afk.envsecret

Brave Search API subscription token, enabling web_scrape search mode. Free tier at https://brave.com/search/api/. When unset, search mode returns an actionable error; markdown and raw modes are unaffected.

System Prompt

AFK_SYSTEM_PROMPT→ afk.env

Raw system-prompt string. Tier-1 source — highest priority over afk.config.json and AFK.md. Note: newlines are not valid in afk.env; if you need a multi-line prompt, use the JSON config systemPrompt field instead.

systemPrompt→ afk.config.json

System prompt stored in afk.config.json. Tier-2 source (lower priority than AFK_SYSTEM_PROMPT env var). Supports multi-line content. Env var equivalent: AFK_SYSTEM_PROMPT.

TELEGRAM_BOT_TOKEN→ afk.envsecret

Telegram bot token from @BotFather. Required to run the Telegram bot surface (afk telegram start).

AFK_TELEGRAM_ALLOWED_CHAT_IDS→ afk.env

Comma-separated list of Telegram chat IDs allowed to interact with the bot. Required when the bot is running. Get your chat ID by messaging @userinfobot.

Advanced options

TELEGRAM_VERBOSE→ afk.env

Set to 1 to log per-message details from the Telegram bot — chat IDs, message text, latency.

AFK_TELEGRAM_CWD→ afk.env

Override the working directory used by the Telegram bot when spawning agent sessions.

TELEGRAM_DATA_DIR→ afk.env

Override the directory where Telegram bot state is stored. Defaults to ~/.afk/state/telegram/.

Daemon

daemon.task→ afk.config.json

Default task description for the daemon. The daemon runs this when started with no explicit task. Env override: AFK_DAEMON_TASK.

daemon.taskId→ afk.config.json

Task identifier the daemon uses to scope its state directory and telemetry. Env override: AFK_DAEMON_TASK_ID.

AFK_DAEMON_CWD→ afk.env

Working directory used by the daemon process for spawned agent sessions.

Advanced options

AFK_SESSIONSTART_COOLDOWN_MS→ afk.env

Cooldown in milliseconds between SessionStart trigger fires. Prevents thundering-herd on rapid restarts.

daemon.worktreePrune.enabled→ afk.config.json

Enable the scheduled worktree-prune job in daemon mode. Default: on.

daemon.worktreePrune.cron→ afk.config.json

Cron expression for the worktree-prune schedule. Default: 4 AM daily.

daemon.worktreePrune.maxAgeDaysClean→ afk.config.json

Max age in days before a clean (no uncommitted changes) worktree is auto-pruned. Env override: AFK_WORKTREE_MAX_AGE_CLEAN.

daemon.worktreePrune.maxAgeDaysDirty→ afk.config.json

Max age in days before a dirty (uncommitted changes) worktree is auto-pruned. Env override: AFK_WORKTREE_MAX_AGE_DIRTY.

daemon.worktreePrune.scope→ afk.config.json

Scope of worktrees targeted by the prune job. Default: all.

Auto-routing

autoRouting.interactive→ afk.config.json

Auto-route bare slash inputs to matching skills in interactive (REPL) mode.

autoRouting.chat→ afk.config.json

Auto-route bare slash inputs to matching skills in chat (afk chat) mode.

autoRouting.telegram→ afk.config.json

Auto-route bare slash inputs to matching skills in Telegram mode.

autoRouting.daemon→ afk.config.json

Auto-route bare slash inputs to matching skills in daemon mode.

Advanced options

AFK_INTERNAL→ afk.env

Tier gate. Set to exactly 1 to unlock — surfaces internal skills (e.g. /forge, /audit-fit, harvest/distill) in the slash-command list, --help, and tab-complete. Default unset = public tier. Gates surfacing only, not access.

Interactive & Worktree

interactive.worktreeAutoname→ afk.config.json

Auto-rename worktree branches based on the first user message. Default: on. Env override: AFK_WORKTREE_AUTONAME=0 to disable.

interactive.worktreeBranchPrefix→ afk.config.json

Branch namespace for AFK-managed worktrees. Default "afk/". Set to empty string to drop the prefix. Env override: AFK_WORKTREE_BRANCH_PREFIX.

interactive.suggestGhost→ afk.config.json

Master toggle for REPL ghost-text suggestions (Tier-1 history + optional Tier-2 LLM). Default: on when unset. Env override: AFK_SUGGEST_GHOST=0.

Advanced options

interactive.worktreeBase→ afk.config.json

Override the base git ref for worktrees created with --worktree. Defaults to the remote default branch, fetched fresh. Set to HEAD to base on the local checkout. Env override: AFK_WORKTREE_BASE; CLI: --worktree-base.

AFK_SUGGEST_GHOST→ afk.env

Enable REPL ghost-text inline suggestions (history dropdown + optional LLM). 1 = on (default), 0 = off. Disables all ghost text when off. Tier-2 LLM is separately gated by AFK_SUGGEST_ENABLED.

AFK_SUGGEST_ENABLED→ afk.env

Enable the LLM-backed ghost-text suggestion tier in the interactive REPL. Set to 1/true/yes/on to activate. Off by default.

AFK_SUGGEST_MODEL→ afk.env

Override the small model used for REPL ghost-text suggestions. Falls back to AFK_COMPACT_MODEL or a haiku-class model.

AFK_WORKTREE_AUTONAME→ afk.env

Auto-rename worktree branches based on the first user message. 1 = on (default), 0 = off. JSON equivalent: interactive.worktreeAutoname.

AFK_WORKTREE_BRANCH_PREFIX→ afk.env

Branch-name prefix for AFK-managed worktrees. Default afk/. Set to empty string to drop the prefix. JSON equivalent: interactive.worktreeBranchPrefix.

AFK_WORKTREE_BASE→ afk.env

Override the base git ref for worktrees. Overridden per-session by --worktree-base. JSON equivalent: interactive.worktreeBase.

AFK_WORKTREE_MAX_AGE_CLEAN→ afk.env

Maximum age (in days) before a clean worktree is auto-pruned. Default 14.

AFK_WORKTREE_MAX_AGE_DIRTY→ afk.env

Maximum age (in days) before a dirty (uncommitted changes) worktree is auto-pruned. Default 30.

Browser Control

Advanced options

AFK_BROWSER_HEADLESS→ afk.env

Override default headless mode for native browser-control tools. 1/true forces headless; 0/false forces headed. When unset: headless for daemon/subagent surfaces, headed for repl/interactive.

AFK_BROWSER_ALLOWED_DOMAINS→ afk.env

Comma-separated allowlist of URL host globs. When set, navigation to hosts outside the list returns blocked_by_policy. Unset = permissive. Combines with the blocklist — block wins.

AFK_BROWSER_BLOCKED_DOMAINS→ afk.env

Comma-separated blocklist of URL host globs. Browser navigation matching any entry returns blocked_by_policy regardless of the allowlist.

Session Behavior

Advanced options

autoResumeOnUsageLimit→ afk.config.json

When on (the default), the CLI auto-waits for the OAuth subscription reset and replays the failed turn rather than surfacing a raw 429 error.

bgSummaries→ afk.config.json

Show background subagent job summaries in /bgsub:list. DATA EGRESS: sends redacted transcript tails (~4 KB) to claude-haiku-4-5 via the Anthropic API. Do NOT enable in air-gapped or secret-sensitive environments. Default: off.

maxSummaryCallsPerSession→ afk.config.json

Session-wide budget for background-summarizer LLM calls. Further refreshes are skipped silently after this count. Default 200, max 500.

Paths

AFK_HOME→ afk.env

Override the AFK home directory. All config, state, and traces live here. Default ~/.afk.

Advanced options

AFK_STATE_DIR→ afk.env

Override the AFK state directory (sessions, todos, daemon state). Default: $AFK_HOME/state/.

Updates

updatePolicy→ afk.config.json

Update-checker policy. "notify" shows a banner on startup; "auto" installs automatically; "off" disables the check entirely.

Debug & UI

AFK_SHOW_DIFFS→ afk.env

Show inline diffs in the tool-lane output for edit/write tool calls.

AFK_BANNER_PLAIN→ afk.env

Suppress the ANSI-colored banner at REPL startup. Useful for non-TTY captures and CI logs.

AFK_DEBUG→ afk.env

Enable verbose debug logging across the codebase.

Advanced options

AFK_SPINNER_TIPS→ afk.env

Show rotating tips in the loading spinner during long calls. 1 = on, 0 = off.

AFK_SHELL_PASSTHROUGH→ afk.env

Enable the REPL !cmd / !&cmd shell-passthrough feature. On by default. Set 0/false/off/no to disable, so inputs beginning with ! are sent to the model as literal text. Equivalent to --no-shell-passthrough.

AFK_DIFF_LINES→ afk.env

Maximum number of diff lines shown in the inline diff render during write_file tool calls. Set to 0 for no cap.

AFK_USER_CARD_MAX_ROWS→ afk.env

Maximum visual rows emitted by the user info card before collapsing the remainder into a "…(N lines collapsed)" row. Default 24.

AFK_WRITE_DENYLIST→ afk.env

Comma-separated list of additional path globs that the write_file tool refuses to write to.

AFK_ALLOW_PROJECT_MCP→ afk.env

Allow loading MCP configuration from <cwd>/.mcp.json. Disabled by default — opt-in to mitigate config-injection risks.

AFK_TRACE_DISABLED→ afk.env

Disable the agent trace subsystem entirely. Set to skip trace file writes under ~/.afk/.

JavaScript is required for the interactive generator. Below is a reference list of the most common configurable fields.

afk.env fields

AFK_MODEL: Default model (sonnet / opus / haiku or full ID). Default: sonnet.
AFK_THINKING: Extended-thinking toggle: on | off | <budget-tokens>. Default: on.
AFK_PROVIDER: anthropic | anthropic-direct | openai | openai-compatible | openai-codex.
ANTHROPIC_API_KEY: Anthropic API key. Secret.
BRAVE_SEARCH_API_KEY: Brave Search token enabling web_scrape search mode. Secret.
TELEGRAM_BOT_TOKEN: Telegram bot token from @BotFather. Secret.
AFK_HOME: Override AFK home directory. Default: ~/.afk.

afk.config.json fields

model / maxTokens / temperature: Core model settings.
updatePolicy: notify | auto | off.
autoRouting: interactive / chat / telegram / daemon booleans.
daemon.worktreePrune: Scheduled worktree-prune knobs (enabled, cron, max ages, scope).
autoResumeOnUsageLimit / bgSummaries: Session-behavior toggles.

Configure ~/.afk/ without reading the docs.

Configure `~/.afk/` without reading the docs.