Settings
Settings overview
How the Settings page is organized, what each group controls, and where every setting is documented in detail.
Settings is a single page inside the Operon desktop app, reached from the account menu. It is organized as a left-hand navigation with a content pane on the right — pick a section on the left, adjust it on the right. This overview explains how those sections are grouped and points you to the page that documents each one in detail.
Note
Almost everything under Settings is per-machine and stored locally under ~/.operon on the device you are using. Changing a setting on one computer does not change it on another. Cloud sync only ever mirrors session metadata — never your settings and never your code.
How the Settings page is laid out
The left navigation splits the sections into three groups. The top group holds your personal setup — profile, appearance, AI configuration, and tool health. The Extensions group holds everything that connects Operon to the outside world — issue trackers, automations, skills, MCP servers, and remote hosts. The System group holds the plumbing — sync, team, the harness, hooks, the CLI, privacy, data controls, and app info.
Group
Account & display
Profile, Appearance, AI Config, and Tools & Health. Who you are, how the app looks, and whether your coding tools are reachable.
Group
Extensions
Integrations, Automations, Skills, MCP Hub, and SSH Hosts. Everything that reaches beyond your machine.
Group
System
Sync, Team, Harness, Hooks, CLI, MCP Server, Privacy, Data, and About. The core plumbing and your data controls.
Where each section is documented
The docs cover every settings section across three pages. Use this table to jump straight to the one you need.
| Settings section | What it controls | Documented in |
|---|---|---|
| Profile | Signed-in account and plan | Account & appearance |
| Appearance | Light or dark theme | Account & appearance |
| AI Config | Optional Anthropic API key and cost alerts | Account & appearance |
| Tools & Health | Detected AI tools and system health checks | Account & appearance |
| Notifications | Opt-in desktop notifications | Account & appearance |
| Integrations | Linear, GitHub, Jira, GitLab, and writeback | Integrations & extensions |
| Automations | Cron, template, and trigger workflows | Integrations & extensions |
| Skills | Install and update agent skills | Integrations & extensions |
| MCP Hub | Install one MCP server for every agent | Integrations & extensions |
| SSH Hosts | Remote machines for remote sessions | Integrations & extensions |
| Sync | Cloud sync and sync levels | System & data |
| Team | Create or join a team workspace | System & data |
| Harness | Checkpoint gate and safety defaults | System & data |
| Hooks | Global vs project hook registration | System & data |
| CLI | The operon command in your shell | System & data |
| MCP Server | Expose Operon data to MCP clients | System & data |
| Privacy | Opt-in anonymous crash reports | System & data |
| Data | Export, clear, and local storage | System & data |
| About | Version, device, and updates | System & data |
Tip
You do not need to touch most of these to use Operon. Sensible defaults ship out of the box — the sections that matter most for a first run are AI Config (optional) and Tools & Health.
Read the section guides
Account & appearance
Your profile, theme, the optional API key, tool health, and notifications.
Integrations & extensions
Connect issue trackers, run automations, install skills and MCP servers, and add remote hosts.
System & data
Sync, teams, the harness, hooks, the CLI, privacy, and your local data controls.