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

# Set up your Project

> Prepare the integrations, repositories, and specification for one product.

Set up one [Project](https://yellowhammer.dev/docs/reference/statuses-and-glossary.md#project) by connecting its services, choosing its local repositories and specification, and reviewing the limits and schedule before unattended work.

## Recommended reading order

Prepare the machine-wide tools first, then complete the Project-specific choices in **Add Project…**. If setup shows **Before You Start**, follow its Settings link to declare a CLI and configure a base route.

> [card] [Connect Orca and agent CLIs](https://yellowhammer.dev/docs/setup/connect-orca-and-agent-clis.md)
>
> Prepare local Worktrees, declare an agent, and check its Probe result.

> [card] [Connect Linear](https://yellowhammer.dev/docs/setup/connect-linear.md)
>
> Install with admin approval and select your workspace and project.

> [card] [Connect GitHub](https://yellowhammer.dev/docs/setup/connect-github.md)
>
> Choose a Code Hosting Connection and check repository access.

> [card] [Add a Project and repositories](https://yellowhammer.dev/docs/setup/add-project-and-repositories.md)
>
> Complete the setup wizard for one product.

> [card] [Prepare your specification](https://yellowhammer.dev/docs/setup/prepare-specification.md)
>
> Choose a source and write traceable completion criteria.

## What a Project contains

The Add Project wizard covers **Project**, **Board**, **Repos**, **Code Hosting**, **Spec Source**, **Bounds**, and **Schedule** (the last pane is titled **Scheduled jobs**). Its sidebar shows each step's summary and readiness. You can revisit steps before confirming **Add Project**.

Workspace connections and Operator identity choices save independently of the Project draft. Cancelling the sheet does not disconnect a workspace you just connected. The Project's permanent ID is confirmed when you add it.

Planned workflow

**Project setup path**

Show how a reader prepares integrations, repositories, and a specification before running a Night.

Planned workflow: connect Linear and GitHub, prepare local execution, define Project scope, and check the specification.

## Before leaving setup

Check that the selected Linear project belongs to the product, every working repository is included, the GitHub check covers those repositories, and the specification source is correct. Choose **Not now** for scheduled jobs if you want to inspect and rehearse the setup first.

## Next steps

[Your first Night](https://yellowhammer.dev/docs/quickstart.md) · [Projects, Features, and Work Cards](https://yellowhammer.dev/docs/concepts/projects-features-and-work-cards.md)


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