> ## 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.

# Reference and troubleshooting

> Look up settings, statuses, commands, and recovery guidance.

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

> [card] [Settings](https://yellowhammer.dev/docs/reference/settings.md)
>
> Find machine-wide connections, agent declarations, routing, and Project configuration.

> [card] [yh command line](https://yellowhammer.dev/docs/reference/yh-command-line.md)
>
> Install the terminal command and choose diagnostic or execution operations.

> [card] [Statuses and glossary](https://yellowhammer.dev/docs/reference/statuses-and-glossary.md)
>
> Interpret Card states, Block Reasons, and Yellowhammer's core terms.

> [card] [Troubleshoot setup and connections](https://yellowhammer.dev/docs/reference/troubleshoot-setup-and-connections.md)
>
> Resolve configuration, authorization, repository, and Probe findings.

> [card] [Troubleshoot Nights and missing results](https://yellowhammer.dev/docs/reference/troubleshoot-nights-and-missing-results.md)
>
> 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](https://yellowhammer.dev/docs/reference/settings.md) · [Understand Yellowhammer](https://yellowhammer.dev/docs/concepts/overview.md)


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