Skip to main content
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

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. 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 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 for the eight default limits and their effects, and routing for inheritance and fallback rules.

Next steps

yh command line · Statuses and glossary