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

# Quick Start

> Create your first project and run a task in 5 minutes

This guide walks you through creating your first project, running a task, and reviewing the result. You'll have an AI agent writing code in under 5 minutes.

## 1. Create a project

<Steps>
  <Step title="Open Claude Board">
    Launch the desktop app. If this is your first launch, the setup wizard will guide you through initial configuration.
  </Step>

  <Step title="Click 'New Project'">
    Enter a project name, slug, and the **working directory** — the local path where Claude will read and write code.

    <Tip>Point the working directory at an existing repository for best results. Claude works best when it can read your existing code structure.</Tip>
  </Step>

  <Step title="Configure permissions">
    Choose a permission mode:

    | Mode              | Best for           | Description                          |
    | ----------------- | ------------------ | ------------------------------------ |
    | **Auto Accept**   | Most users         | Claude uses all tools without asking |
    | **Allowed Tools** | Security-conscious | Only specified tool categories       |
    | **Default**       | Custom setups      | Uses Claude's built-in settings      |

    <Warning>Claude runs with `--no-input`, so it cannot ask for permission interactively. Use "Auto Accept" for best results.</Warning>
  </Step>
</Steps>

## 2. Create and run a task

<Steps>
  <Step title="Click 'New Task'" icon="plus">
    Write a clear, specific description. The more detail you provide, the better Claude performs.

    <Accordion title="Example: Good vs. vague task descriptions">
      **Good:**

      ```
      Title: Add JWT authentication middleware
      Description: Implement login/register endpoints with JWT tokens.
      Use bcrypt for password hashing. Add middleware for protected routes.
      Follow the existing Express.js patterns in src/routes/.
      ```

      **Too vague:**

      ```
      Title: Add auth
      Description: Make authentication work
      ```
    </Accordion>
  </Step>

  <Step title="Configure the task" icon="sliders">
    | Setting      | Options                                           | When to use                                                                     |
    | ------------ | ------------------------------------------------- | ------------------------------------------------------------------------------- |
    | **Model**    | `opus` / `sonnet` / `haiku`                       | Opus for complex, Sonnet for balanced, Haiku for simple                         |
    | **Type**     | feature / bugfix / refactor / docs / test / chore | Categorizes the task and matches [prompt templates](/features/prompt-templates) |
    | **Priority** | low / medium / high / urgent                      | Affects [queue order](/features/queue)                                          |
  </Step>

  <Step title="Start the task" icon="play">
    Drag the task to **In Progress** or right-click and select "In Progress". Claude spawns immediately, creates a branch, and starts coding.
  </Step>

  <Step title="Watch the live terminal" icon="terminal">
    Click the terminal icon on the task card to watch Claude work in real-time. You'll see:

    * **Read** — files Claude is examining
    * **Write/Edit** — code changes being made
    * **Bash** — commands being executed (tests, git, etc.)
  </Step>

  <Step title="Review the result" icon="check">
    When Claude finishes, the task moves to **Testing**. Click the review button to:

    * **Approve** — moves to Done, optionally creates a PR
    * **Request Changes** — provide feedback, Claude iterates automatically
  </Step>
</Steps>

## 3. Level up

Now that you've run your first task, explore these features to get more out of Claude Board:

<Columns cols={2}>
  <Card title="Orchestration" icon="sitemap" href="/features/orchestration">
    Set up dependency graphs and run tasks in parallel waves.
  </Card>

  <Card title="Auto-Queue" icon="bolt" href="/features/queue">
    Configure hands-free execution with concurrency limits.
  </Card>

  <Card title="Context Snippets" icon="file-lines" href="/features/snippets">
    Inject project rules and coding standards into every prompt.
  </Card>

  <Card title="Git Automation" icon="code-branch" href="/features/git-automation">
    Auto-create branches and PRs per task.
  </Card>
</Columns>