> ## Documentation Index
> Fetch the complete documentation index at: https://panopticon-cli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings reference: every section of the Overdeck Settings page

> What each of the 29 Settings page sections controls, where it saves, and which page documents it in full.

Settings is one scrolling page at `/settings`, with every section listed in a left-hand nav in a fixed order. There are no per-section URLs. Most controls save automatically as you make them; most sections write to `~/.overdeck/config.yaml`, and a few write elsewhere, named in the table below. The Conversation Search part of Conversations is the one exception to autosave: it marks itself unsaved as you edit it and only writes when you click its own **Save embeddings** button. The Experimental switch, in the last section, hides eight dashboard views from the More menu; it does not hide any Settings section, and every section below stays visible and usable regardless of that switch.

| Section | What it controls | Where it is saved | More |
| - | - | - | - |
| Model Routing | Presets, Workhorse Models, Role Models | `workhorses`, `roles` in `config.yaml` | [Model routing](https://panopticon-cli.com/configuration/model-routing.md), [Model presets](https://panopticon-cli.com/configuration/model-presets.md) |
| Providers | Provider API keys, "Show all harness/model permutations", "Default harness" | `models.providers` (including each provider's default harness), `api_keys` and `experimental.showHarnessModelPermutations` in `config.yaml` | [Model routing](https://panopticon-cli.com/configuration/model-routing.md), [Harnesses](https://panopticon-cli.com/configuration/harnesses.md) |
| Permissions | Claude Code's Auto or Bypass mode; Codex's Read-only, Workspace, Auto-review or Full access mode | `claude.permissionMode`, `codex.permissionMode` in `config.yaml` | [Permissions](https://panopticon-cli.com/configuration/permissions.md) |
| Security | Semgrep switches | `security.semgrep` in `config.yaml` | [Semgrep](https://panopticon-cli.com/configuration/semgrep.md) |
| Computer Use | "Allow agents to use the desktop" | `computer_use.enabled` in `config.yaml` | [Computer use](https://panopticon-cli.com/configuration/computer-use.md) |
| Coding Agents | "Keep coding-agent CLIs up to date automatically" | `harnesses.auto_update` in `config.yaml` | [Harnesses](https://panopticon-cli.com/configuration/harnesses.md) |
| Tiered Execution | "Route work by difficulty" and the tier crews | `tiered_execution` in `config.yaml` | [Model routing](https://panopticon-cli.com/configuration/model-routing.md#tiered-execution) |
| Swarming | "Automatic selection", "Maximum slots per issue", "Advance waves automatically" | `swarm.*` in `config.yaml` | [Swarm](https://panopticon-cli.com/features/swarm.md) |
| Cloister | "Max work agents" (default 6), "Reserved advancing slots" (default 3) | `~/.overdeck/cloister.toml` | [Cloister](https://panopticon-cli.com/features/cloister.md) |
| Close-out | "Remove the workspace when an issue is closed out", "Delete the feature branch at close-out" | `cloister.toml` | [Workspaces](https://panopticon-cli.com/features/workspaces.md#cleaning-up-after-close-out) |
| Merge Train | "Batch size", "Batch wait (minutes)" | Overdeck database | [Merge batches](https://panopticon-cli.com/features/merge-batches.md) |
| Session Vault | Cross-machine conversation backup | `~/.overdeck/vault/config.json` | [Session Vault](https://panopticon-cli.com/configuration/session-vault.md) |
| Anywhere | Status card, Account, Paired devices, Machines, Directory, Fleet versions, Overdeck on your tailnet (once Tailscale is ready), Triggers, Access tokens, Bots, Public MCP for hosted bots, Phone notifications | Split across the account service and local device and link state | [Anywhere](https://panopticon-cli.com/anywhere.md) |
| Remote | "Resiliency tier" (Ephemeral or Durable), "Max concurrent remote agents" | `remote.*` in `config.yaml` | [Remote workspaces on Fly](https://panopticon-cli.com/features/workspaces.md#remote-workspaces-on-fly) |
| Access Tokens | Token table, "Require a token to sign in" | Tokens in `~/.overdeck/access-tokens.json`; "Require a token to sign in" in `dashboard.require_token_mint` in `config.yaml` | [Remote access](https://panopticon-cli.com/configuration/remote-access.md) |
| Voice | "STT provider", "AutoPreso provider", "AutoPreso model", devices and volume | `~/.overdeck/voice-settings.json`; device and volume choice stays in the browser | [Voice and TTS](https://panopticon-cli.com/configuration/voice.md#choose-the-speech-to-text-provider); see also [AutoPreso](https://panopticon-cli.com/features/dashboard-views.md#autopreso) (experimental: turn on Settings → Experimental → **Experimental features** to show it) |
| Conversations | Compaction, title and handoff models, "/compact handling", "Rich summaries", "Auto-settle on merge", "Auto-settle idle conversations", Conversation Search | `conversations.*` in `config.yaml`, except "Auto-settle on merge" and "Auto-settle idle conversations", which the Overdeck database holds; Conversation Search needs its own **Save embeddings** click | [Conversations](https://panopticon-cli.com/features/conversations.md) |
| Memory | Extraction provider and model, "Daily cost cap", "Disable observations", "Prompt-time injection" | `memory.*` in `config.yaml` | [Memory](https://panopticon-cli.com/configuration/memory.md) |
| Background AI | "Low-cost mode", per-feature rows, "TypeSafe API key (Jev)" | `background_ai.*` in `config.yaml`; the TypeSafe key in `api_keys.typesafe` and the Jev panel in `jev.*` | [Jev](https://panopticon-cli.com/configuration/jev.md) |
| Terminal | "tmux configuration" (Managed or Inherit user) | `tmux.config_mode` in `config.yaml` | No page documents this setting; it applies only to the tmux backend ([Terminal backend](https://panopticon-cli.com/configuration/terminal-backend.md#opting-into-tmux)) |
| TTS | "Enable TTS", "Daemon", "Volume", "Rate" | `tts.*` in `config.yaml` | [Voice and TTS](https://panopticon-cli.com/configuration/voice.md#control-what-is-spoken) |
| Tracker Keys | Linear, GitHub, GitLab, Rally and Jira keys | `tracker_keys.*` in `config.yaml`, overriding the environment variables | [Issue trackers](https://panopticon-cli.com/configuration/issue-trackers.md) |
| GitHub Identities | Read-only table: Owner, Project, Repository, Acts as, Why | Nothing; this section only displays existing state | [Issue trackers](https://panopticon-cli.com/configuration/issue-trackers.md) |
| Appearance | "Overdeck Theme", "Color theme", "Ready to Merge shimmer" | "Overdeck Theme" in `ui.theme` and "Color theme" in `ui.color_theme` in `config.yaml` (theme files live in `~/.overdeck/themes/`); "Ready to Merge shimmer" in this browser's `localStorage` only | [Appearance](https://panopticon-cli.com/configuration/appearance.md) |
| Diff | "Diff style", "Line wrapping" and other diff display options | This browser only | No page |
| Desktop App | Tray badge, notifications, launch at login (desktop app only) | Desktop app local settings | [Desktop app](https://panopticon-cli.com/features/desktop-app.md) |
| Maintenance | "Issue cache" clear | Not persisted; it clears a runtime cache | No page |
| Telemetry | "Share anonymous usage data", "Group my installs (pseudonymous)" | `telemetry.*` in `config.yaml` | [Telemetry](https://panopticon-cli.com/configuration/telemetry.md) |
| Experimental | "Experimental features", "RTK Bash compression", "Claude Code Channels", "Streamdown renderer" | `experimental.*` in `config.yaml` (RTK writes `agents.rtk.enabled`) | [Experimental features](https://panopticon-cli.com/features/dashboard-views.md#experimental-features) |

Diff preferences and the Ready to Merge shimmer toggle are the exceptions to the `config.yaml` pattern above: they live only in this browser and are never synced or backed up.

## Get help

Still stuck? Ask on the [Overdeck Discord](https://discord.gg/ZpHE2ZTv5P) or file a [GitHub Issue](https://github.com/eltmon/overdeck/issues).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.