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

# Quickstart

> Turn your first idea into a working product

This quickstart will cover:

* [Creating an Account](#create-your-account)
* [Starting to Build: Creating a Plan](#start-building)
* [Specifying Requirements](#specify-requirements)
* [Installing the BrainGrid CLI, and configuring your agent](#install-the-braingrid-cli)
* [Building it with your favorite AI coding tool](#build-it-with-your-favorite-ai-coding-tool)

## Let's get started!

<Steps>
  <Step title="Create your Account" titleSize="h2">
    <div id="create-your-account" />

    Go to [https://app.braingrid.ai](https://braingrid.link/docs/sign-up) and create an account.

    Give your organization a name and pick a username.

    <Frame>
      <img className="block dark:hidden" width="75%" src="https://mintcdn.com/braingrid/tSeF6d5OOPjrIz3Y/images/welcome-to-braingrid-light.jpg?fit=max&auto=format&n=tSeF6d5OOPjrIz3Y&q=85&s=fe8453399d9c3d86de9dc2f6a1e66249" alt="Creating your BrainGrid Account." data-path="images/welcome-to-braingrid-light.jpg" />

      <img className="hidden dark:block" width="75%" src="https://mintcdn.com/braingrid/tSeF6d5OOPjrIz3Y/images/welcome-to-braingrid-dark.jpg?fit=max&auto=format&n=tSeF6d5OOPjrIz3Y&q=85&s=fd1e22daa421ec11ce74823c2682ab2e" alt="Creating your BrainGrid Account." data-path="images/welcome-to-braingrid-dark.jpg" />
    </Frame>
  </Step>

  <Step title="Start building with a prompt" titleSize="h2">
    <div id="start-building" />

    <Frame>
      <img className="block dark:hidden" width="75%" src="https://mintcdn.com/braingrid/6JiG2ORgkWVq-MYs/images/start-building-light.jpg?fit=max&auto=format&n=6JiG2ORgkWVq-MYs&q=85&s=51df9b8a658bdc46ffce4c83b66e6074" alt="Start Building with a prompt." data-path="images/start-building-light.jpg" />

      <img className="hidden dark:block" width="75%" src="https://mintcdn.com/braingrid/6JiG2ORgkWVq-MYs/images/start-building-dark.jpg?fit=max&auto=format&n=6JiG2ORgkWVq-MYs&q=85&s=e654d048b685918a1bec0609e79375e0" alt="Start Building with a prompt." data-path="images/start-building-dark.jpg" />
    </Frame>

    Now it is time to start building. Enter a prompt that describes what you are looking to build. Note that you can connect your prompt to a GitHub repository.

    If you have not yet connected your GitHub account to BrainGrid, there are [detailed instructions](github-installation).

    Once you enter your prompt that describes your idea, the agent will start thinking and analyzing the codebase (if it exists). It can come back with some clarifying questions to help it understand the requirement better, or ask you if you are comfortable with the plan proposed. Iterate with the agent until you are happy with the plan.

    <Frame>
      <img className="block dark:hidden" width="75%" src="https://mintcdn.com/braingrid/6JiG2ORgkWVq-MYs/images/the-plan-light.jpg?fit=max&auto=format&n=6JiG2ORgkWVq-MYs&q=85&s=cd58bf681c370edc7abbeab6e79ceeba" alt="Examine the plan, and choose to accept it or not." data-path="images/the-plan-light.jpg" />

      <img className="hidden dark:block" width="75%" src="https://mintcdn.com/braingrid/6JiG2ORgkWVq-MYs/images/the-plan-dark.jpg?fit=max&auto=format&n=6JiG2ORgkWVq-MYs&q=85&s=36f7a7106b49faaedc42dbe707633f37" alt="Examine the plan, and choose to accept it or not." data-path="images/the-plan-dark.jpg" />
    </Frame>

    Once you accept the plan, BrainGrid will use the plan to create an EPIC user story.  Several requirements are stubbed out that will be used to implement the plan.

    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/braingrid/UBICoHGvPk9HSeV9/images/Accepted-plan-light.jpg?fit=max&auto=format&n=UBICoHGvPk9HSeV9&q=85&s=0aa8b0b8aecf395e802ab6fa50bf268e" alt="Accepted plan becomes an epic user story with requirements stubbed out." width="2578" height="2166" data-path="images/Accepted-plan-light.jpg" />

      <img className="hidden dark:block" src="https://mintcdn.com/braingrid/UBICoHGvPk9HSeV9/images/Accepted-plan-dark.jpg?fit=max&auto=format&n=UBICoHGvPk9HSeV9&q=85&s=5a959f077f4a9296be54c30d8a88c391" alt="Accepted plan becomes an epic user story with requirements stubbed out." width="2548" height="2144" data-path="images/Accepted-plan-dark.jpg" />
    </Frame>
  </Step>

  <Step title="Specify the requirements" titleSize="h2">
    <div id="specify-requirements" />

    In the right frame of BrainGrid, the proposed requirements are listed.  Click "Specify" to begin building the specifications around a requirement.  BrainGrid will begin building the requirement.  It may ask clarifying questions to refine and enhance the requirements.

    <Frame>
      <img className="block dark:hidden" width="50%" src="https://mintcdn.com/braingrid/6JiG2ORgkWVq-MYs/images/requirement-questions-light.jpg?fit=max&auto=format&n=6JiG2ORgkWVq-MYs&q=85&s=d578a160c7fcca0cab3a89647f56975c" alt="Refine the rough idea with AI into a detailed specification" data-path="images/requirement-questions-light.jpg" />

      <img className="hidden dark:block" width="50%" src="https://mintcdn.com/braingrid/6JiG2ORgkWVq-MYs/images/requirement-questions-dark.jpg?fit=max&auto=format&n=6JiG2ORgkWVq-MYs&q=85&s=319293ff9da62f00bbd3da643c6f24c9" alt="Refine the rough idea with AI into a detailed specification" data-path="images/requirement-questions-dark.jpg" />
    </Frame>

    Once completed, A full requirements document is created that outlines what will be built. You can ask the agent to make changes, clarify things, add or remove details (or you can edit the document manually.)

    <Frame>
      <img className="block dark:hidden" src="https://mintcdn.com/braingrid/6JiG2ORgkWVq-MYs/images/requirement-1-light.jpg?fit=max&auto=format&n=6JiG2ORgkWVq-MYs&q=85&s=41f108f19de10b7abf240c45f00dd1b5" alt="Refine the rough idea with AI into a detailed specification" width="4952" height="2436" data-path="images/requirement-1-light.jpg" />

      <img className="hidden dark:block" src="https://mintcdn.com/braingrid/6JiG2ORgkWVq-MYs/images/requirement-1-dark.jpg?fit=max&auto=format&n=6JiG2ORgkWVq-MYs&q=85&s=c25600f12d79900cc470003036a6f281" alt="Refine the rough idea with AI into a detailed specification" width="4960" height="2526" data-path="images/requirement-1-dark.jpg" />
    </Frame>

    We are now ready to build!
  </Step>

  <Step title="Install the BrainGrid CLI, and configure your agent" titleSize="h2">
    <div id="install-the-braingrid-cli" />

    Before we can build locally, we need to install BrainGrid's Command Line Interface (CLI).

    In the local directory of your repository:

    ```bash theme={null}
    npm install -g @braingrid/cli #install BrainGrid with NPM
    braingrid login               #login to BrainGrid (a browser tab will open)
    braingrid init                #initialize the BrainGrid project in your local repository.
    ```

    If you have Claude Code or Cursor installed, you will be prompted to install the BrainGrid integration into those tools. (Claude code shown as an example):

    <Frame>
      <img src="https://mintcdn.com/braingrid/UBICoHGvPk9HSeV9/images/braingrid-init.jpg?fit=max&auto=format&n=UBICoHGvPk9HSeV9&q=85&s=36f5205a3d483232f2d598f9a4bfb521" alt="Initialize the BrainGrid CLI" width="1784" height="864" data-path="images/braingrid-init.jpg" />
    </Frame>

    <Note>
      Need more help? Check our detailed [CLI installation guide](/cli/overview).
    </Note>
  </Step>

  <Step title="Begin Building" titleSize="h2">
    <div id="begin-building" />

    We are now ready to begin building.  If you click the "Start Building" button, you will see detailed instructions for your AI Agent:

    <Frame>
      <img className="block dark:hidden" width="75%" src="https://mintcdn.com/braingrid/UBICoHGvPk9HSeV9/images/build-your-requirement-light.jpg?fit=max&auto=format&n=UBICoHGvPk9HSeV9&q=85&s=6f3937dd199b8cadc71a61853f241d5a" alt="Time to Start Building - press the button!" data-path="images/build-your-requirement-light.jpg" />

      <img className="hidden dark:block" width="75%" src="https://mintcdn.com/braingrid/UBICoHGvPk9HSeV9/images/build-your-requirement-dark.jpg?fit=max&auto=format&n=UBICoHGvPk9HSeV9&q=85&s=321e521e74bb5976841eb0c286c8d2d1" alt="Time to Start Building - press the button!" data-path="images/build-your-requirement-dark.jpg" />
    </Frame>
  </Step>

  <Step title="Build it with your favorite AI coding tool" titleSize="h2">
    <div id="build-it-with-your-favorite-ai-coding-tool" />

    Now you're ready to implement your tasks using your AI coding assistant!

    <Frame>
      <img className="block dark:hidden" width="75%" src="https://mintcdn.com/braingrid/UBICoHGvPk9HSeV9/images/build-your-requirement-instructions-light.jpg?fit=max&auto=format&n=UBICoHGvPk9HSeV9&q=85&s=8f09ebc1e57a01466f50b8776a3725ac" alt="Instructions to build your requirement." data-path="images/build-your-requirement-instructions-light.jpg" />

      <img className="hidden dark:block" width="75%" src="https://mintcdn.com/braingrid/UBICoHGvPk9HSeV9/images/build-your-requirement-instructions-dark.jpg?fit=max&auto=format&n=UBICoHGvPk9HSeV9&q=85&s=fa9ba4d105302556b05ce6809e5c7342" alt="Instructions to build your requirement." data-path="images/build-your-requirement-instructions-dark.jpg" />
    </Frame>

    In your Agent, follow the instructions from BrainGrid:

    <Frame>
      <img src="https://mintcdn.com/braingrid/UBICoHGvPk9HSeV9/images/build-with-claude.jpg?fit=max&auto=format&n=UBICoHGvPk9HSeV9&q=85&s=07aa49a9d2feb8ffb5f76829330de093" width="75%" alt="Build instruction in Claude." data-path="images/build-with-claude.jpg" />
    </Frame>

    You Agent will connect with BrainGrid, read the EPIC and requirement, and begin building!
  </Step>
</Steps>

Congratulations! You've completed the quickstart.

Now you can start building your product with BrainGrid!

## Video Guides

Check out our complete [Video Guides](/guides/create-project) section for detailed walkthroughs of each step in the BrainGrid workflow.
