Skip to main content
Set up one Project by connecting its services, choosing its local repositories and specification, and reviewing the limits and schedule before unattended work. 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.

Connect Orca and agent CLIs

Prepare local Worktrees, declare an agent, and check its Probe result.

Connect Linear

Install with admin approval and select your workspace and project.

Connect GitHub

Choose a Code Hosting Connection and check repository access.

Add a Project and repositories

Complete the setup wizard for one product.

Prepare your specification

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 · Projects, Features, and Work Cards