Preferences

Preferences customise the browser experience and defaults that agents use for pricing estimates, Docker images, git attribution, shortcuts, and plugin marketplace sources.

Preferences and Account open the same Settings window, with the same entry points and keyboard shortcuts as before. Choose a section from the grouped desktop sidebar or the mobile section selector. Appearance and Shortcuts are under General; Git identity and attribution and Docker are under Workspace defaults. Plugins and the machine-level editors are under Daemon configuration. See the full Settings navigation map.

These groups organise navigation only: browser, personal, organisation, daemon, and project settings retain their existing scope and storage.

Appearance

• Density changes UI spacing: compact, default, or relaxed.
• Font size changes message text size: small, medium, or large.
• Language sets the browser UI language and document language metadata.

The header theme toggle separately controls light, dark, or system theme.

Pricing

Find pricing estimates under Settings → Models → LLM.

Pricing rows map model name prefixes to token rates per one million tokens: input, output, cache write, and cache read. AFK uses the first matching prefix to estimate cost in usage badges and session status.

model prefix: claude-
rates: input 3, output 15, cache write 3, cache read 0.3

Change the currency symbol when you want estimates shown in a different display currency. Pricing is an estimate; provider bills remain the source of truth.

Git identity and attribution

Git identity sets the default commit author for remote Docker sessions. Leave it blank to use the selected daemon's git config. In org context, org-specific identities can differ from personal defaults.

Commit attribution is appended to common agent-created git commit messages and injected into commit-writing instructions. PR attribution is suggested for agent-created pull request bodies. Use {{model}}in the attribution text to include the active model name.

Docker packages

Docker package preferences are apt package names installed into the Docker agent image at build time. Changes take effect the next time a Docker session starts and AFK builds a new image. The package picker can search available apt packages, but you can add a package manually if suggestions are unavailable.

Plugins can also declare packages in their plugin.json; AFK merges those package requirements automatically.

Shortcuts

Plugins

The Plugins section manages installed user plugins and configured marketplace sources. Add marketplace sources by GitHub shorthand, git URL, SSH URL, or direct marketplace JSON URL. See Plugin marketplace.

Guidelines

The Guidelines section edits the selected daemon's user instructions in ~/.afk/AGENTS.md. They apply to sessions launched on that machine. Project and private checkout guidelines stay in the session /guidelines editor.

Skills and agents

The Skills and Agents sections manage user-level skills and custom agents stored on the selected daemon. They are available to sessions launched on that machine; project-level skills and agents stay with their checkout and are managed from the session UI.

LSP

The LSP section overrides language-server commands on the selected daemon. Entries are stored in that daemon's lsp.json and apply to sessions on that machine. Leave a language empty to keep auto-detection, project dev dependencies, and bundled defaults.

MCP

The MCP section edits daemon-owned user MCP servers in ~/.afk/mcp.json on the selected machine. Project and local MCP files stay with the checkout and are edited from the session /mcp command.

Hooks

The Hooks section edits daemon-owned user hooks in ~/.afk/hooks.json on the selected machine. Project and local hook files stay with the checkout and are edited from the session /hooks command.