Skip to content
Orbital
Menu
DocsExamplesReference
Get started
OverviewInstall OrbitalStart your first runBuild with AI
Concepts
How Orbital worksRunsWorkflowsDurability after restartsProjects and foldersHarnesses and modelsStyles and personas
Runs
Start a runWatch a runMessage a runPause, stop or resolve a runThe run queue
Workflows
Write your first workflowWrite promptsAdd branchesDecide with a modelAdd a loopRun steps in parallelReuse a workflowPass context between stepsAdd gates and waitsPush and open pull requestsRepeat a workflowOne-off workflows
Automate
TriggersMake a trigger ruleDelivery leadLead deliveryChats
Configure
Create a projectWorktrees and deliverySwitch a run's harnessUse different modelsGive steps a styleSettingsSet up decision modelsRun on your other computers
Connect agents
Connect a coding agentUse the shipped skillsCommand line
Troubleshooting
Troubleshooting
Changelog
Changelog

Settings

Where Settings is and what each of its sections is for

Change how Orbital runs, harnesses, styles, 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, stalled turn limit and open worktrees in.Settings, General page with Appearance set to match the computer, light or dark, followed by concurrent runs, default workflow, default harness, stalled turn limit and open worktrees in.
General holds the appearance and the settings for runs, worktrees and the server.

The sections

Section titled “The sections”
Section What it is for
General Appearance on this device, and the settings for runs, worktrees and the server.
Harnesses Whether each harness can start, how Orbital starts it, and where a run goes when its harness runs out of quota.
Delivery lead How the delivery lead looks after your runs. It appears only while the delivery lead experimental feature is on.
Presets Named sets of turn settings, such as harness, model, effort and persona, that every workflow can name, and the preset in use that runs follow.
Personas Named prompts that tell an agent who it is. Styles pick one with persona.
Decision models The models that decide steps and deciding fan-outs ask, such as Jev, Clef, Laya and Kev, with their keys and thresholds.
GitHub The GitHub token Orbital uses for its GitHub requests, and where it looks for one.
Linear The Linear key that Linear trigger rules use to check Linear.
MCP The MCP endpoint that lets coding agents outside Orbital read and control your runs.
Costs The prices, in USD per million tokens, that Orbital uses to estimate what runs cost.
Command line and skills Installs the orbital command and Orbital’s agent skills.
Experimental features Switches for features still being tried out. Each is off until you turn it on.
Recent changes The newest changes to your settings, with who or what made each one and when.
About The version that is running, its updates, where your settings are kept, and the licenses of the open source packages Orbital ships.

Harnesses

Section titled “Harnesses”

Settings > Harnesses shows whether each harness 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.
Check here first when a run cannot start its harness.

GitHub

Section titled “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.
The token sources list shows which token Orbital uses.
Section titled “Related”