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

# Your first Night

> Follow the learning path from prerequisites to reviewing a Night result.

Prepare one [Project](https://yellowhammer.dev/docs/reference/statuses-and-glossary.md#project), check its local tools and service access, then run its first [Night](https://yellowhammer.dev/docs/reference/statuses-and-glossary.md#night) and review the results in Linear and GitHub. Acme Checkout is an illustrative product used below.

## Before you begin

Check [Requirements](https://yellowhammer.dev/docs/start/requirements.md). Use an Apple Silicon Mac running macOS 26 or later, local repository and specification checkouts, Orca ADE, Linear, GitHub, and an authenticated supported coding agent CLI.

Planned workflow

**Your first Night learning path**

Show the progression from requirements through Project setup and specification preparation to Night review.

Planned visual: prepare a Project, let a local Night work on one Feature, then review its Linear records and pull requests.

## 1. Prepare the machine

Open **Settings → Agent CLIs**, declare the installed CLI, and configure a route naming it in **Base Routing Table**. Run **Probe Now** and resolve any failure before relying on unattended dispatch. Confirm setup can find Orca. Follow [Connect Orca and agent CLIs](https://yellowhammer.dev/docs/setup/connect-orca-and-agent-clis.md).

If you want terminal access to `yh`, choose **Install…** in **Settings → General → Command Line Tool**. Scheduled jobs use the bundled executable and do not depend on this optional terminal link.

## 2. Add the Project

Open **Add Project…** and complete its steps:

1. Name the Project, for example Acme Checkout, and inspect its permanent ID.
2. Connect Linear through local or remote admin approval. Choose your Operator identity and the Linear project.
3. Add working repositories with their Repo Roles and Check commands. Review proposed Repo Dependencies.
4. Select a GitHub connection and inspect the repository access report.
5. Select the specification source and review the per-Project Bounds.
6. Open **Schedule** and set the Night window. Choose **Not now** for scheduled jobs while you review setup, then choose **Add Project** and confirm the ID.

Read the run log and choose **Done** after success. The [setup guide](https://yellowhammer.dev/docs/setup/add-project-and-repositories.md) explains each decision and setup failure.

## 3. Check the Project before unattended work

Open the Project in Settings and confirm its repositories, Linear project, specification source, and connections. Follow [Rehearse before scheduling](https://yellowhammer.dev/docs/run/rehearse-before-scheduling.md) to configure and run a rehearsal when you want to exercise the flow first. A rehearsal needs a separate declared rehearsal Linear project and Journal; it writes to Linear but never dispatches an agent, pushes, or opens a pull request.

## 4. Start work and configure the schedule

Select the Project and choose **Start Author** in the toolbar to start its author Act. This starts authoring; it does not itself run the entire author/build/land sequence. Follow [Configure the schedule](https://yellowhammer.dev/docs/run/configure-the-schedule.md) to install or refresh the scheduled jobs that run those Acts automatically.

Keep the Mac available during its Night window. The jobs can run with Yellowhammer quit. Watch progress in the Project's [Pulse and Inspector](https://yellowhammer.dev/docs/review/understand-pulse-and-inspector.md), and respond to questions in Linear when needed.

## 5. Review the result

Read the [Night Summary](https://yellowhammer.dev/docs/review/read-the-night-summary.md), inspect the Features and Work Cards in Linear, and follow any pull request links to GitHub. A Night can progress through several Features within its configured limits. Review the evidence and any incomplete or blocked work before deciding what to merge.

## Confirm it worked

The Project is visible in Yellowhammer, its authored work is visible in the intended Linear project, and the Night Summary explains the outcome. When work reaches publication, GitHub has pull requests for your review. A blocked or incomplete Night can still produce useful progress; use the recorded reason to decide your next action.

## Next steps

[Review the morning](https://yellowhammer.dev/docs/review/overview.md) · [Understand the lifecycle of a Night](https://yellowhammer.dev/docs/concepts/lifecycle-of-a-night.md)


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