> ## Documentation Index
> Fetch the complete documentation index at: https://yellowhammer.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> Find the settings that shape Project setup and Night behavior.

Yellowhammer's Settings window separates shared Mac configuration from each Project's configuration. Open **Settings…** from the Yellowhammer application menu and choose a section in the sidebar.

## Machine-wide settings

| Section | What you manage |
| - | - |
| General | Read how Orca ADE is located, install or update the `yh` Command Line Tool, and inspect diagnostic prompt templates and recorded diagnostic dispatches. |
| Boards | Connect Linear workspaces and manage their Board Connections and Operator identities. |
| Code Hosting | Manage the GitHub Code Hosting Connections that Projects use for publication. |
| Agent CLIs | Declare installed CLIs, inspect Probe findings and routing eligibility, and run **Probe Now** or **Probe Again**. |
| Repo Roles | Declare repository roles for routing and see the roles already in use. |
| Base Routing Table | Edit shared Card routes, fallbacks, authoring, and Verification; test a hypothetical Card. |
| Refused Files | Read Project configuration files the loader rejected and their diagnostics. |

Orca ADE has no Yellowhammer-specific setting: setup resolves `orca` on the tool path saved into scheduled jobs. Manage the local Orca installation and registered repositories in Orca ADE.

The Command Line Tool installs a symlink at `/usr/local/bin/yh` for interactive terminal use. Its installation does not change scheduled jobs, which invoke the engine bundled in the app directly.

## Project settings

Choose a Project's name in the sidebar. Its **Configuration** and **Recalibrate** tabs share the Project's scope.

| Configuration section | Editable behavior |
| - | - |
| Project | Change its display name. The Project id is permanent. |
| Linear | Inspect its fixed workspace and Board Connection, and edit the Linear project id. |
| Code Hosting | Select another connection, then choose **Change connection** to check push access before switching. |
| Spec Source | Inspect the configured source folder; this display is read-only. |
| Repos | Add or remove Repos and edit their name, path, Repo Role, Check, and comma-separated Protected paths. |
| The Night | Edit Starts, Ends, and Build every. Saving a changed schedule regenerates installed LaunchAgents. |
| Bounds | Edit the eight per-Project effort and escalation limits. |
| Routing overrides | Replace matching base Routing Table entries or add Project-specific mappings. |
| Prompt catalog | Inspect the prompt templates used for the Project. |

Use **Save** to validate and write form edits, or **Revert** to discard unsaved changes. Saving rewrites the Project TOML file, so comments and layout are not retained. Direct file editing remains supported. The app displays validation refusals instead of treating invalid edits as saved configuration.

The Linear workspace is fixed for the Project's life. Moving to another workspace requires removing and adding the Project again. **Remove Project…** is available beneath both tabs; the removal workflow keeps the Journal for history.

## Recalibrate

**Recalibrate** reports the selected Night and how close it came to each Bound. You can edit and save new Bound values, refresh the report, and start **Run a Rehearsal Night…** when its separate rehearsal context is configured. Follow [Rehearse before scheduling](https://yellowhammer.dev/docs/run/rehearse-before-scheduling.md) before starting it.

## Defaults and saved configuration

Machine configuration lives in `~/.config/yellowhammer/config.toml`; each Project has `projects/<project-id>.toml` beneath that directory. The engine reads configuration on each invocation. Inspect the relevant Project's saved values rather than assuming all Projects share the base defaults.

The default Night window is 22:00 to 06:00 with a 15-minute build interval. See [Bounds and Protected Paths](https://yellowhammer.dev/docs/run/set-limits-and-protected-paths.md) for the eight default limits and their effects, and [routing](https://yellowhammer.dev/docs/run/choose-agents-and-routes.md) for inheritance and fallback rules.

## Next steps

[yh command line](https://yellowhammer.dev/docs/reference/yh-command-line.md) · [Statuses and glossary](https://yellowhammer.dev/docs/reference/statuses-and-glossary.md)


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