https://github.com/sourcebot-dev/sourcebot
Sourcebot is a self-hosted tool that helps humans and agents understand your codebase.
https://github.com/sourcebot-dev/sourcebot
code-intelligence code-search fair-source sourcebot
Last synced: 11 days ago
JSON representation
Sourcebot is a self-hosted tool that helps humans and agents understand your codebase.
- Host: GitHub
- URL: https://github.com/sourcebot-dev/sourcebot
- Owner: sourcebot-dev
- License: mit
- Created: 2024-08-23T20:40:37.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-10-16T00:55:15.000Z (14 days ago)
- Last Synced: 2026-10-16T16:36:57.373Z (13 days ago)
- Topics: code-intelligence, code-search, fair-source, sourcebot
- Language: Python
- Homepage: https://sourcebot.dev
- Size: 83.8 MB
- Stars: 3,990
- Watchers: 12
- Forks: 372
- Open Issues: 96
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Agents: AGENTS.md
- Claude: CLAUDE.md
- Cursor: .cursor/rules/cloud_agent.mdc
Awesome Lists containing this project
- awesome-AI-driven-development - Sourcebot - a self-hosted tool that helps you understand your codebase. (Code Analysis & Search / Other IDEs)
- awesome-x-ops - sourcebot - hosted code search and understanding tool for humans and AI agents to navigate, query, and comprehend large codebases. (Platform Engineering / Code Search and Understanding)
- metorial-index - Sourcebot Code Search Server - Enables regex-based code search across multiple code hosts such as GitHub, GitLab, and BitBucket to retrieve relevant code snippets and repository information. Provides LLM agents with enhanced context for improved reasoning and response quality without requiring local repository checkouts. (APIs and HTTP Requests)
- toolsdk-mcp-registry - ✅ @sourcebot/mcp
- awesome-mcp-security - @sourcebot - hosted tool that helps developers understand codebases through AI-powere... | 92 ✅ | 3.2k | [表示](https://agentseal.org/mcp/sourcebot) | (カテゴリ / 💻 <a name="code--ide"></a>コード・IDE)
- awesome - sourcebot-dev/sourcebot - Sourcebot is a self-hosted tool that helps humans and agents understand your codebase. (TypeScript)
README
Code understanding for humans and agents
Website ·
Docs ·
Public demo ·
Changelog
Sourcebot is a self-hosted code context layer for humans and AI agents. Index all your repos in one place so you and your agents can search and navigate them.
## Get started
Run the setup wizard:
```sh
npx setup-sourcebot
```
You'll need Node.js (24 LTS recommended), Docker, and Docker Compose.
This wizard walks you through indexing your repos, optionally configuring a language model provider (for [Ask Sourcebot](https://docs.sourcebot.dev/docs/features/ask/ask-sourcebot)), and then creates the config files for you and starts up Sourcebot.
For manual setup, use [Docker Compose](https://docs.sourcebot.dev/docs/deployment/docker-compose) or the [Helm chart](https://github.com/sourcebot-dev/sourcebot-helm-chart). Check out our [docs](https://docs.sourcebot.dev/) for more info on how to configure Sourcebot.
## Code Context for Agents
Your agent can use [Sourcebot MCP](https://docs.sourcebot.dev/docs/features/mcp-server) to search repos you haven't checked out locally. For example, it can find callers of an API in other services or read the implementation for dependencies that you don't have checked out locally.
The MCP server exposes code search, file reading, and symbol definitions and references for the repos you've indexed. Open **Settings → MCP** in Sourcebot to connect Claude Code, Codex, Cursor, or another MCP client. The [MCP docs](https://docs.sourcebot.dev/docs/features/mcp-server) cover setup and authentication for each client.
Connect repos from GitHub, GitLab, Bitbucket, Azure DevOps, or local Git directories using the [connection guides](https://docs.sourcebot.dev/docs/connections/indexing-your-code). [Permission syncing](https://docs.sourcebot.dev/docs/features/permission-syncing) controls access based on your code host's repository permissions.
## Code Search
[Code Search](https://docs.sourcebot.dev/docs/features/search/code-search) lets you search across all your indexed repos and branches in one place. Find uses of a dependency, track down a function, or look for a pattern across services without cloning each repo.
Use regular expressions and boolean queries, then narrow the results by repo, file, language, or symbol definition. Results include syntax-highlighted code, with repo and language filters alongside them.
Try it: [example search](https://app.sourcebot.dev/search?query=render%20lang%3Atypescript) in the public demo.
[](https://app.sourcebot.dev/search?query=render%20lang%3Atypescript)
## Ask Sourcebot
[Ask Sourcebot](https://docs.sourcebot.dev/docs/features/ask/ask-sourcebot) answers questions about your codebase, including repos you haven't checked out locally. Ask how a feature works or what a migration would involve. [Connectors](https://docs.sourcebot.dev/docs/features/ask/connectors) let Ask access your apps and services with your permissions, so it can pull in context and take actions like creating a Linear or Jira issue with its findings. It searches your code and follows references using the same tools as the MCP server.
Open cited code alongside the answer, explore generated diagrams, and share the conversation with your team. Ask runs on a [language model provider you configure](https://docs.sourcebot.dev/docs/configuration/language-model-providers) (Bring Your Own Key), so you control where your code is sent.
Try it: [explore an example Ask Sourcebot conversation](https://app.sourcebot.dev/chat/cmt1kzlyv0062oq5axens5rdl) in the public demo.
[](https://app.sourcebot.dev/chat/cmt1kzlyv0062oq5axens5rdl)
Try both in the [public demo](https://app.sourcebot.dev). See [pricing](https://www.sourcebot.dev/pricing) for plan details.
## Feedback
[Report a bug or request a feature](https://github.com/sourcebot-dev/sourcebot/issues/new/choose).