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 155 optionsEvery env var + JSON field, by category — skip anything you don't need

Model & Sampling14

Read the docs↗

AFK_MODEL→ afk.envdocs↗

Default model for agent turns. Tier names (small/medium/large/local) follow whatever that slot is bound to; sonnet/opus/haiku/fable pin one fixed model. Defaults to the medium tier.

AFK_THINKING→ afk.env

Extended thinking: adaptive lets afk decide per turn, enabled:max always thinks, disabled turns it off. Custom accepts a token budget.

AFK_EFFORT→ afk.env

Reasoning-effort level for providers that expose one.

Advanced options

AFK_PROMPT_CACHE_TTL→ afk.env

TTL for Anthropic prompt-cache blocks.

AFK_MAX_TOKENS→ afk.env

Deprecated and ignored by the generation path. Use AFK_MAX_OUTPUT_TOKENS to cap per-response output tokens.

AFK_MAX_OUTPUT_TOKENS→ afk.env

Cap on output tokens per turn. Falls back to the provider default when unset.

maxTokens→ afk.config.json

Token cap written to afk.config.json.

temperature→ afk.config.json

Sampling temperature. Leave unset to use the provider default.

AFK_MAX_BUDGET_USD→ afk.env

Hard spend ceiling for a single run, in USD. The run stops when it is reached.

AFK_VISION_MODELS→ afk.env

Comma-separated override for image (vision) capability detection on the openai-compatible provider.

CLAUDE_MODEL→ afk.env

Legacy alias for AFK_MODEL, kept for pre-AFK_* deployments. Prefer AFK_MODEL.

AFK_DISABLE_PROMPT_CACHE→ afk.env

Disable Anthropic prompt caching when set to 1/true/yes/on.

AFK_TEMPERATURE→ afk.env

Numeric temperature override for model sampling.

model→ afk.config.json

Default model id / alias.

Model Slots & Local Models16

Provider & Endpoints6

API Keys5

Safety & Permissions10

System Prompt2

Telegram14

Daemon8

Auto-routing6

Interactive & UI22

Worktrees11

Browser Control7

Session & Context18

Paths4

Updates1

Debug & Diagnostics11

Beyond this form

This page writes two files: afk.config.json and afk.env. These parts of setup live in the CLI, where they belong.

Check your setupafk doctor
Health check across auth, config, provider reachability and state directories.
Sign inafk login
Interactive auth. Browser OAuth cannot happen in a config file — use this instead of pasting a token.
Connect Telegramafk telegram setup
Walks token entry and the chat allowlist without the token passing through anything else. Then afk telegram start.
Keep it runningafk service install
Installs a launchd agent (macOS) or systemd --user unit (Linux) so the bot and daemon survive reboot.
Schedule recurring workafk schedule add
Cron-driven tasks in schedules.json. afk schedule list / logs to inspect runs.
Add MCP servers
Edit ~/.afk/config/mcp.json by hand. A repo-local .mcp.json also works, but is fail-closed — set AFK_ALLOW_PROJECT_MCP above to opt in, because it spawns that repo’s commands.
Give afk project context
Run /init inside the REPL to generate an AFK.md for the repo. It is the highest-leverage file you can add.
Change one key laterafk config set <key> <value>
You do not need this page again — afk config get/set edits both artifacts in place.

JavaScript is required for the interactive generator. Below are the most common configurable fields, generated from the same registry the form uses (155 fields total, from agent-afk v5.84.13).

afk.env fields

AFK_MODEL: Default model for agent turns. Tier names (small/medium/large/local) follow whatever that slot is bound to; sonnet/opus/haiku/fable pin one fixed model. Defaults to the medium tier. Default: medium.
AFK_THINKING: Extended thinking: adaptive lets afk decide per turn, enabled:max always thinks, disabled turns it off. Custom accepts a token budget. Default: adaptive.
AFK_EFFORT: Reasoning-effort level for providers that expose one.
AFK_MODEL_LOCAL: Bind the "local" tier to a model served by Ollama, LM Studio, vLLM or MLX. Pair with the base URL below.
AFK_MODEL_LOCAL_BASE_URL (human-gated): OpenAI-compatible endpoint for the local tier, e.g. http://localhost:11434/v1 (Ollama) or http://localhost:1234/v1 (LM Studio).
AFK_MODEL_LOCAL_API_KEY (secret): Bearer token for the local endpoint. Local servers ignore the value but reject an empty one — "local" is the conventional placeholder.
AFK_MODEL_SMALL: Bind the "small" tier (cheap/fast work) to a model id or alias.
AFK_MODEL_MEDIUM: Bind the "medium" tier — the default tier for agent turns.
AFK_MODEL_LARGE: Bind the "large" tier (hardest work) to a model id or alias.
AFK_PROVIDER: Force a provider instead of inferring it from the model. Leave unset unless you are pointing afk at a non-default endpoint.
ANTHROPIC_API_KEY (secret): Anthropic API key — the primary credential for Claude models.
OPENAI_API_KEY (secret): OpenAI API key, used for OpenAI and OpenAI-compatible providers.
EXA_API_KEY (secret): Exa (exa.ai) key that enables web_scrape search mode. Without it, search returns an error while page fetches keep working. Free tier available.
TELEGRAM_BOT_TOKEN (secret): Bot token from @BotFather. Required to run the Telegram surface.
AFK_TELEGRAM_ALLOWED_CHAT_IDS (human-gated): Comma-separated chat ids allowed to drive the bot. This is the allowlist — an empty list means nobody can reach it.
AFK_WRITE_DENYLIST: Extra path globs the write_file tool must refuse, e.g. **/.env,**/secrets/**. Comma-separated.
AFK_READ_DENYLIST: Extra absolute paths the read/grep/glob tools must refuse, colon-separated. Built-in credential paths (~/.ssh, ~/.aws, ~/.afk/config) always apply and cannot be removed.
AFK_WORKTREE_AUTONAME: Name new afk worktrees automatically from the task instead of prompting.
AFK_WORKTREE_BRANCH_PREFIX (human-gated): Branch prefix for afk-created worktrees. Defaults to afk/. Default: afk/.
AFK_BROWSER_HEADLESS: Run the managed browser headless. Turn off to watch it work.
AFK_BROWSER_ALLOWED_DOMAINS (human-gated): Allowlist for browser navigation. When set, anything outside it is refused — the tightest control over where the agent can browse.

afk.config.json fields

permissionMode (human-gated): Permission mode for afk chat and the interactive REPL. Left unset, a new install runs as bypassPermissions: path containment and the per-path approval prompt are off. Set "default" to turn both back on.
systemPrompt (human-gated): Replaces afk’s built-in system prompt. Multi-line is fine here — afk.env cannot hold newlines, so prefer this over AFK_SYSTEM_PROMPT.
telegram.notify.mode (human-gated): Notification fan-out. "custom" is what makes the targets list below take effect.
telegram.notify.primaryChatId (human-gated): The single chat that receives notifications in "primary" mode.
daemon.task (human-gated): The prompt the daemon runs on its schedule.
autoRouting.interactive: Route bare slash input to a matching skill in the interactive REPL.
theme: Colour palette for the REPL and all CLI output. Display-only — never affects behaviour.
interactive.thinkingUi: How extended-thinking blocks render in the REPL. Display-only — it does not control whether thinking runs.
bgSummaries: Summarise background subagent results into the session when they land.
autoResumeOnUsageLimit: Resume automatically once a provider usage limit resets, instead of ending the run.
enforceDoneEvidence (human-gated): Require a durable artifact — a file path, commit or test output — before a turn may report Done. An honesty gate against unverified success claims.
updatePolicy (human-gated): What afk does when a new version exists: notify, install automatically, or stay quiet.

Configure ~/.afk/ without reading the docs.

Beyond this form

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