> ## Documentation Index
> Fetch the complete documentation index at: https://docs.specpilot.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started

> Install SpecPilot, open your project in the SpecPilot App and take your first task from Backlog to Completed with your agent.

This takes about ten minutes. You need Node.js (see [What you need](https://docs.specpilot.dev/index.md#what-you-need) on the Introduction page), a project folder and an AI IDE such as Claude Code, Cursor or Copilot.

**1. Install SpecPilot**

Nothing to install up front: `npx specpilot serve` fetches it each time. If you will use it every day, install it once with `npm i -g specpilot` and run `specpilot serve` instead.

**2. Start the App in your project**

Open a terminal in your project folder and run `npx specpilot serve`. The terminal prints the address, [http://127.0.0.1:4321](http://127.0.0.1:4321), and the line Claude Code needs for `.mcp.json`. Open the address in your browser, or add `--open` and SpecPilot opens it for you.

**3. Find your way from Home**

If the folder already has `.specs/`, you land on your project. Otherwise use Home: Open a Project Folder, Start a New Project or Clone a Repository. Projects you open show up under Recent projects next time.

**4. Set up your specs with your AI IDE**

A folder without `.specs/` shows "Set up SpecPilot for this project" in three steps. Connect your AI IDE: copy the config and add it to your IDE. Tell it what to do: copy the prompt and paste it into your agent. Progress then updates by itself while your agent reads the code, answers what it can, asks you the rest and writes the files.

**5. Tour the board**

Open Tasks under Plan. Your tasks sit in four lanes: Backlog, Current Sprint, Review and Completed. Drag the tasks you want to work on next into Current Sprint.

**6. Create a task**

Click Add Task. Give it a type, a priority and a description, and click Add Task again. It lands in Backlog with the next ID, as a new row in `planning/tasks.md`.

**7. Let your agent pick it up**

Drag the task into Current Sprint and ask your agent to take the next task. It reads the specs, does the work and moves the task to Review when it is done. You can pick up tasks yourself the same way.

**8. Review it**

Open the task in Review. Approve it, and your agent records it in Completed with its commit. Or choose Send back…, add a note, and it goes back to the top of Current Sprint for the next try.

## Next steps

> [card] [Core concepts](https://docs.specpilot.dev/concepts/specs-folder.md)
>
> The .specs folder, tasks and lanes, Review and the commands your AI IDE gets.

> [card] [Introduction](https://docs.specpilot.dev/index.md)
>
> What SpecPilot is and how specs, the board, your agent and Review fit together.


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