Skip to main content
Use Yellowhammer’s reference pages to look up a setting, interpret a Linear record, or diagnose why a Project did not produce the result you expected.

​
Find the right reference

Settings

Find machine-wide connections, agent declarations, routing, and Project configuration.

yh command line

Install the terminal command and choose diagnostic or execution operations.

Statuses and glossary

Interpret Card states, Block Reasons, and Yellowhammer’s core terms.

Troubleshoot setup and connections

Resolve configuration, authorization, repository, and Probe findings.

Troubleshoot Nights and missing results

Inspect missed firings, stopped work, and publication failures.

​
Diagnose a problem

Start with the selected Project’s Night Card, Night Summary, and affected Work Card. The Managed Block names a blocked Card’s reason and next action. Make triage decisions in Linear; use Settings for local configuration. If no Night Card exists, use yh status --project YOUR_PROJECT_ID to inspect scheduled jobs, recent runs, sleep history, and missed Nights. Use yh doctor --project YOUR_PROJECT_ID to check readiness. Ordinary diagnostics report findings; doctor --fix is an explicit repair operation.
Planned workflow
Find the right reference

Route readers from a settings or status question to the correct reference or troubleshooting page.

Planned workflow: look up settings, command syntax, or status first; follow symptom-based troubleshooting when diagnosing a failure.

​
Next steps

Settings · Understand Yellowhammer