> 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/welcome.md).

# Welcome

NeoHive gives your coding agents your codebase and your team's knowledge, from a server you run yourself.

**Coding agents that share what your whole team knows.**

NeoHive is a self-hosted context layer: one memory that your team's coding agents share. Connect your repositories, documents, and team knowledge once, and every agent on your team reads from that memory. That includes Claude Code, Cursor, Codex, and any other agent that supports the [Model Context Protocol (MCP)](/reference/glossary.md#mcp). When one teammate corrects an agent, every agent on the team gets the correction.

NeoHive updates the memory as your repositories change. Each note your team saves also improves the answers that every agent gets. That memory lives on machines that you control, because NeoHive runs inside your network.

## Start here

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-rocket">:rocket:</i></td><td><strong>Quickstart</strong></td><td>Install NeoHive and get your first answer from your own code.</td><td><a href="/get-started/quickstart.md">Quickstart</a></td></tr><tr><td><i class="fa-comments">:comments:</i></td><td><strong>Your first session</strong></td><td>Ask about your code, teach one convention, and see the convention come back next session.</td><td><a href="/get-started/first-session.md">Your first session</a></td></tr><tr><td><i class="fa-diagram-project">:diagram-project:</i></td><td><strong>How NeoHive works</strong></td><td>Learn about Hives, Indexes, and how your agent reaches them.</td><td><a href="/core-concepts/how-it-works.md">How NeoHive works</a></td></tr><tr><td><i class="fa-code-branch">:code-branch:</i></td><td><strong>Add a repository</strong></td><td>Connect your repositories, such as GitHub or GitLab repositories.</td><td><a href="/add-your-context/repositories.md">Add a repository</a></td></tr><tr><td><i class="fa-file-import">:file-import:</i></td><td><strong>Import rules from CLAUDE.md and AGENTS.md</strong></td><td>Bring your existing context files into NeoHive.</td><td><a href="/add-your-context/migrate.md">Import rules from CLAUDE.md and AGENTS.md</a></td></tr><tr><td><i class="fa-graduation-cap">:graduation-cap:</i></td><td><strong>Teach your agent as you work</strong></td><td>Correct your agent once, and every teammate's agent remembers it.</td><td><a href="/get-better-results/teach.md">Teach your agent as you work</a></td></tr></tbody></table>

## Why it exists

Coding agents fall short on a team in the following ways:

* **Every developer teaches their own agent.** A correction that one person makes in Claude Code doesn't reach a teammate's Cursor.
* **Every agent starts from zero.** Your agent doesn't know your codebase, your conventions, or the library that you moved off last quarter.
* **Context files don't scale.** A `CLAUDE.md` file can grow to thousands of lines, and the agent loads the whole file, even when the task needs only a small part of it.
* **Reasoning is the first thing lost.** Teams rarely write down why they made a decision, but that reason is what the next agent needs most.

NeoHive gives your team one persistent memory that every agent reads from and every teammate adds to. That memory lives in a [Hive](/reference/glossary.md#hive), your team's workspace. A Hive holds [Indexes](/reference/glossary.md#index), which store your code, your documents, and the [Memories](/reference/glossary.md#memory) that your team saves. For more information about the problem and how NeoHive solves it, see [What is NeoHive?](/get-started/what-is-neohive.md).

## What NeoHive does

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-magnifying-glass">:magnifying-glass:</i></td><td><strong>Knows your codebase</strong></td><td>NeoHive indexes your repositories, so your agent finds code by what it does, not by guessing file names.</td><td><a href="/core-concepts/retrieval.md">How retrieval works</a></td></tr><tr><td><i class="fa-file-lines">:file-lines:</i></td><td><strong>Reads your documents</strong></td><td>NeoHive indexes the specs, runbooks, and PDFs you upload to a Files Index, so your agent recalls them like code.</td><td><a href="/add-your-context/documents.md">Add documents and images</a></td></tr><tr><td><i class="fa-arrows-rotate">:arrows-rotate:</i></td><td><strong>Stays up to date</strong></td><td>NeoHive syncs your repositories on a schedule. Each sync indexes only the files that changed.</td><td><a href="/add-your-context/repositories/sync.md">Keep a repository up to date</a></td></tr><tr><td><i class="fa-book-open">:book-open:</i></td><td><strong>Keeps your team's knowledge</strong></td><td>NeoHive stores conventions, decisions, and debugging notes as Memories. Everyone's agent can recall what one person teaches.</td><td><a href="/add-your-context/team-knowledge.md">Capture team knowledge</a></td></tr><tr><td><i class="fa-puzzle-piece">:puzzle-piece:</i></td><td><strong>Works with every agent</strong></td><td>NeoHive connects to Claude Code, Cursor, and Codex through plugins, and to ChatGPT, Claude Desktop, or any other MCP app directly.</td><td><a href="/get-started/connect.md">Connect your agent</a></td></tr><tr><td><i class="fa-laptop">:laptop:</i></td><td><strong>Runs on your machine</strong></td><td>NeoHive keeps your code, documents, Memories, and recall queries on the machine it runs on. NeoHive doesn't send that content to an outside service.</td><td><a href="/security-and-privacy/local-only.md">What stays on your machine</a></td></tr></tbody></table>

## Built for teams

A Hive is shared, so what one person teaches their agent helps the whole team:

* **One Hive, every agent.** Your teammates' agents read from the same Hive, whichever tool each teammate uses.
* **Teach once.** When you correct your agent or explain a convention, the agent saves that note as a Memory in your Hive. Every teammate's agent then recalls that Memory.
* **Notes outlast team changes.** The note stays in the Hive, so someone who joins next month has it on their first day.


---

# 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/welcome.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.
