> For the index of every page in Orbital's docs, read https://docs.beta.runorbital.dev/llms.txt.

# Settings

> Where Settings is and what each of its sections is for

Change how Orbital runs, harnesses, roles, connected services and the app itself work in Settings. Open **Settings** from the sidebar, then pick a section from the list on the left.

Every value saves as soon as you finish with it. A text field saves when you press Enter or leave the field. A **Reset** button appears next to a label whose value you changed from its default. A line under a field says when the change applies, for example "Applies to runs started afterwards."

![Settings, General page with Appearance set to match the computer, light or dark, followed by concurrent runs, default workflow, default harness, keep harness stream, stalled turn limit and open worktrees in.](/screenshots/settings-general.webp?v=cb0897c671)

*General holds the appearance and the settings for runs, worktrees and the server.*

## The sections

| Section | What it is for |
| --- | --- |
| [General](/reference/settings/#general) | Appearance on this device, and the settings for runs, worktrees and the server. |
| [Harnesses](/reference/settings/#harnesses) | Whether each harness can start, how Orbital starts it, and where a run goes when its harness runs out of quota. |
| [Supervisor](/reference/settings/#supervisor) | How the Supervisor looks after your runs. It appears only while the Supervisor experimental feature is on. |
| [Roles](/reference/settings/#roles) | Roles that give a step a persona, model settings and tool access in one choice. |
| [Personas](/reference/settings/#personas) | Persona prompts that agent turns can use. |
| [Model settings](/reference/settings/#model-settings) | Named choices of harness, model and effort for a step. |
| [Tool access](/reference/settings/#tool-access) | Which kinds of tool a step can use. |
| [GitHub](/reference/settings/#github) | The GitHub token Orbital uses for its GitHub requests, and where it looks for one. |
| [Linear](/reference/settings/#linear) | The Linear key that Linear trigger rules use to check Linear. |
| [MCP](/reference/settings/#mcp) | The MCP endpoint that lets coding agents outside Orbital read and control your runs. |
| [Costs](/reference/settings/#costs) | The prices, in USD per million tokens, that Orbital uses to estimate what runs cost. |
| [Command line and skills](/reference/settings/#command-line-and-skills) | Installs the `orbital` command and Orbital's agent skills. |
| [Experimental features](/reference/settings/#experimental-features) | Switches for features still being tried out. Each is off until you turn it on. |
| [Recent changes](/reference/settings/#recent-changes) | The newest changes to your settings, with who or what made each one and when. |
| [About](/reference/settings/#about) | The version that is running, its updates, and where your settings are kept. |

## Harnesses

**Settings > Harnesses** shows whether each [harness](/harnesses/) is installed and signed in. Below the status table, each harness has its own settings, such as its program and default model.

![Settings, Harnesses page with a status table showing whether Claude, Codex and OpenCode are installed and signed in, followed by Claude's settings for turned on, program, default model, default effort and environment variables.](/screenshots/settings-harnesses.webp?v=6446e71ff0)

*Check here first when a run cannot start its harness.*

## GitHub

**Settings > GitHub** saves a token for Orbital's GitHub requests. It also lists the places Orbital looks for a token, in order. The first source with a token is used.

![Settings, GitHub page showing a saved token and the token sources in order: saved token, GH_TOKEN, GITHUB_TOKEN and gh auth login.](/screenshots/settings-github.webp?v=f898ede9d3)

*The token sources list shows which token Orbital uses.*

## Related

- [Settings reference](/reference/settings/): every field, its default and its allowed values
- [Harnesses and models](/harnesses/): how Orbital picks and starts each harness
- [Roles and tool access](/roles/): what the library sections do for steps
- [Connect a coding agent](/mcp/connect/): use the MCP section to register a client
- [Troubleshooting](/troubleshooting/): fixes that name each switch in Settings