> For the complete documentation index, see [llms.txt](https://docs.neohive.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neohive.ai/get-started/quickstart.md).

# Quickstart

The shortest path from nothing to a coding agent that answers from your own repository.

In this quickstart, you install NeoHive, index one GitHub repository, and connect Claude Code so that Claude Code can answer questions about your code. For more information about each step, or to connect a different agent, see [Install NeoHive](/get-started/install.md).

Before you start, you need the following:

* Docker 20 or later, installed and running on Linux, macOS, or Windows with WSL2.
* Port `3577` free on the machine.
* A NeoHive license file (`license.key` or `license.json`) from the [NeoHive team](https://www.neohive.ai/download/).
* Claude Code.
* A GitHub personal access token with `repo` scope.

{% stepper %}
{% step %}

## Install NeoHive

Run the installer from the folder that holds your license file:

```bash
bash <(curl -fsSL https://raw.githubusercontent.com/NeoHiveAI/install/main/install.sh)
```

When the installer finishes, it prints the dashboard addresses.
{% endstep %}

{% step %}

## Create a Hive with your repository

A [Hive](/reference/glossary.md#hive) is a workspace for your team, with one address that agents connect to. To create the Hive, do the following:

1. Open the dashboard address that the installer printed, such as `http://localhost:3577`.
2. If the license opens, read it, and then click **I Understand**.
3. Read through the welcome screens, and then click **Start setup**.
4. In **Name Hive**, enter a name for your Hive.
5. In **Configure first Index**, select **GitHub**, paste your token, click **Fetch repositories**, and then select your repository.
   {% endstep %}

{% step %}

## Connect Claude Code

Setup then shows **Install for your AI tools** with **Claude** selected. To connect Claude Code, do the following:

1. In your terminal, go to your repository's root folder.
2. Run the command that setup shows. The command looks like this:

   ```bash
   claude mcp add <name> '<hive-url>' \
     --scope project \
     --transport http \
     --header 'x-mcp-client: claude-code'
   ```
3. Start Claude Code in your repository.
4. When Claude Code asks, approve the NeoHive server. Setup shows **Connected** after Claude Code connects.
5. To install the plugin and run its setup, which checks that Claude Code can reach the Hive, run the following commands inside Claude Code:

   ```
   /plugin marketplace add NeoHiveAI/NeoHiveClaude
   /plugin install neohive@neohive-claude
   /reload-plugins
   /neohive:getting-started
   ```
6. When setup shows **Connected**, click **Open** followed by your Hive's name. NeoHive then creates the Index and indexes your repository in the background, so your agent can search your code. If you leave setup without clicking the **Open** button, NeoHive deletes the Hive.

   If setup doesn't show **Connected**, click **Skip**, and then click **Continue without MCP**. Then see [Agent can't connect](/troubleshooting/connection.md).

To check when indexing finishes, see [Connect GitHub or GitLab](/add-your-context/repositories/connect.md#create-the-index).
{% endstep %}

{% step %}

## Ask about your code

When indexing finishes, ask Claude Code a question that only your code can answer:

```
How does the authentication middleware work?
```

Claude Code calls `memory_recall` and answers with real paths from your repository.
{% endstep %}
{% endstepper %}

## Next step

You've installed NeoHive and connected Claude Code, so you can skip **Install NeoHive** and **Connect your agent**. Continue with [Your first session](/get-started/first-session.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.neohive.ai/get-started/quickstart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.