Sourcegull

Name: Sourcegull
Author: sourcegull

by sourcegullversion 0.10.0i★ 13iRuns in the cloud

Registry nameio.github.sourcegull/sourcegull

How to install

What it does

Code search and navigation across your GitLab, GitHub and Gitea repositories, self-hosted.

Connects Runs in the cloud
Account or key No key needed
Category Developer tools

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · What you ask goes through the maker’s server ({sourcegull_host}) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude, with some setup first

The address has {…} parts you must replace with your own first · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

Open Claude’s Connectors page
CustomizeConnectors
Done
Click “Add” → “Custom” → “Web” and fill in these 2 fields
Copy each value into the field with the same name in Claude, then click Continue
Name · NameSourcegull
Remote MCP server URL · Addresshttps://{sourcegull_host}/.api/mcp
Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add
Done
Turn it on in a chat
+ConnectorsSourcegull
Done
Try it
Use Sourcegull and tell me what you can do for me, then show me one thing
✓ If Claude says it is using Sourcegull or shows a Sourcegull tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only · The address has {…} parts you must replace with your own first

Open ChatGPT’s add-MCP page on the web
Plugins+Add custom MCP server
Done
Fill in the name and address
Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin
Name · NameSourcegull
Connection · Addresshttps://{sourcegull_host}/.api/mcp
Done
Pick Sourcegull in a chat
Start a new chat and pick Sourcegull from your plugins before typing
Done
Try it
Use Sourcegull and tell me what you can do for me, then show me one thing
✓ If ChatGPT says it is using Sourcegull or shows a Sourcegull tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code, with some setup first

The address has {…} parts you must replace with your own first

Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done

Paste this command and press Enter

claude mcp add --transport http --scope user sourcegull 'https://{sourcegull_host}/.api/mcp'

Done

Type /mcp in Claude Code
You should see Sourcegull listed as connected
Done
Try it
Use Sourcegull and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using Sourcegull or shows a Sourcegull tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

The address has {…} parts you must replace with your own first

1
Open Cursor’s MCP settings file
~/.cursor/mcp.json
Paste these settings, fill in the empty values and save
```
{
  "mcpServers": {
    "sourcegull": {
      "url": "https://{sourcegull_host}/.api/mcp"
    }
  }
}
```
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use Sourcegull and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using Sourcegull or shows a Sourcegull tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

The address has {…} parts you must replace with your own first

1
Open VS Code’s MCP settings file
MCP: Open User Configuration
Paste these settings, fill in the empty values and save
```
{
  "servers": {
    "sourcegull": {
      "type": "http",
      "url": "https://{sourcegull_host}/.api/mcp"
    }
  }
}
```
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use Sourcegull and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using Sourcegull or shows a Sourcegull tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://{sourcegull_host}/.api/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Sourcegull💬 Discussion →

For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user sourcegull 'https://{sourcegull_host}/.api/mcp'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "sourcegull": {
      "url": "https://{sourcegull_host}/.api/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "sourcegull": {
      "type": "http",
      "url": "https://{sourcegull_host}/.api/mcp"
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub stars i: 13
Downloads per weeki: Not on npm/PyPI
Licence i: Apache-2.0
Connection: Runs in the cloud
Transport: streamable-http
Latest versioni: 0.10.0
Categoryi: Developer tools
Published to registryi: Nov 13, 2026
Code last changedi: Nov 13, 2026
Maker: sourcegull
Repo: sourcegull/sourcegull
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

Claude ChatGPT Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Open WebUI Raycast

All apps, with pros and cons →

What it can do

The address needs your own values, so we cannot read the tool list for you.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 15, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account sourcegull, which owns the repo
✓ Pass
Still maintained
Code last changed 2 days ago
✓ Pass
Has a licence
Uses Apache-2.0
– Not applicable
Endpoint responds
The address needs your own account values, so we cannot check it for you
– Not applicable
Sign-in with OAuth
The address needs your own account values, so we cannot check it for you
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

What we check → · JSON

Makers: ask for a re-check or report wrong info

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Developer toolsi

More stars than 91% of the other 5921 servers in this category
Published to the registry more recently than 94% of the other 5921 servers in this category
Basic checks equal to or better than 100% of the other 5921 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Sourcegull safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 2 days ago, and the latest version (0.10.0) reached the registry 2 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitDiagram

Architecture diagrams, explanations and Mermaid source for public GitHub repositories.

by ahmedkhaleel2004Widely used★ 18.9KUpdated 2 months ago

Runs in the cloud✓ service owner · gitdiagram.comTried by the PopNx team

How to connect

Appllama

Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.

by AppllamaWidely used★ 5.2KUpdated 3 months ago

Runs in the cloud✓ service owner · appllama.io

How to connect

Cloudflare MCP

Cloudflare MCP servers

by cloudflareWidely used★ 4.5KUpdated 14 months ago

Runs in the cloud✓ service owner · mcp.cloudflare.comTried by the PopNx team

How to connect

Omnara

Deploy durable AI agents with Omnara, an open-source managed-agent platform.

by omnara-aiWidely used★ 3.4KUpdated 2 months ago

Runs in the cloud✓ service owner · omnara.com

How to connect

Repowise

Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.

by repowise-devWidely used↓ 6.5K/wk★ 8.1K Stars for the whole repoUpdated 2 days ago

Computer or cloud✓ service owner · repowise.dev

Install

GitDiagram — Runs in the cloud, nothing to install · No key needed
Appllama — Runs in the cloud, nothing to install · No key needed
Cloudflare MCP — Runs in the cloud, nothing to install · No key needed · In Claude’s directory
Omnara — Runs in the cloud, nothing to install · No key needed
Repowise — Cloud or install on your computer · No key needed

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Find code across thousands of repositories in milliseconds, with up to 50× fewer tokens. For you and your agents.

Self-hosted code search and code intelligence for GitLab, GitHub and Gitea, written in Rust. Every feature is open source under Apache-2.0, including SSO, SCIM, RBAC and audit logs. There is no paid tier, and there will not be one.

Quick install · Production install · Documentation · Query language · AI agents (MCP) · Architecture · Development

Fast search, fewer tokens

Agents connected over MCP read only the lines that answer their question, with up to 50× fewer tokens than cloning and grepping (token usage).

Sourcegull uses a trigram index of its own. After a push, only the changed paths are written to a delta shard, so new commits are searchable within seconds without rebuilding the repository's index. Small repositories are packed together into compound shards, which keeps instances with thousands of repositories fast. Revisions that are not indexed (any branch, tag or commit) are searched straight from git. Results stream as they are found.

How it compares with the alternatives on the same GitLab: Benchmark.

Everything is free

Every feature is in this repository under Apache-2.0. There is no enterprise edition, no licence key and no paid tier, and the project will not add one. That includes the features that other code search products usually sell separately:

Single sign-on with GitLab, GitHub or Gitea OAuth, OpenID Connect or an authenticating proxy (HTTP header), and SCIM provisioning.
Roles (RBAC), repository permissions synced from GitLab and enforced on every read, and an audit log.
Precise code navigation from SCIP indexes, across repositories and package versions, uploaded from GitLab CI or built by auto-indexing, with search-based results filling in for repositories that are not indexed.
Bulk changes: one YAML spec changes many repositories, then opens and tracks the GitLab merge requests.
Trends, watches and exhaustive search jobs with CSV/JSONL export.
Repository storage across several repo nodes, added or removed without downtime.
Usage analytics that stay on the instance.
An MCP server for AI coding agents.

Also included: literal, regexp, keyword (BM25) and structural search; notebooks; code ownership; saved searches and search contexts; a GraphQL API, the gull CLI and outbound webhooks; Grafana dashboards and documented alerts. See the documentation.

Ready for production

One Rust binary, and PostgreSQL (16 or newer) is its only stateful dependency. Nothing is sent to a vendor cloud.
No telemetry. Usage analytics stay on the instance.
Docker Compose for one host, a Helm chart for Kubernetes. Every release is tested by upgrading from the previous one.
Repository storage spreads across several repo nodes, which you can add or remove without downtime.
Stored secrets are encrypted, and the keys rotate without a restart.
Grafana dashboards and Prometheus alerts are included.
Configuration as code: sign-in, code host connections and site admins come from files in git, and secrets come from the environment.
GitLab (gitlab.com and self-managed) has every feature. GitHub (github.com and Enterprise Server) and Gitea support repository sync, permission sync, webhooks and sign-in.
Several code hosts at once: connect gitlab.com, a self-managed GitLab, GitHub and Gitea side by side, and one search covers all of them, each with its own permissions.

Quick install

To try Sourcegull or run it for a small team on one host, download the Compose bundle of the latest release and start PostgreSQL and Sourcegull with the published image, ghcr.io/sourcegull/sourcegull (linux/amd64):

curl -fsSL https://github.com/sourcegull/sourcegull/releases/latest/download/sourcegull-compose.tar.gz | tar -xz

cd sourcegull-compose echo "POSTGRES_PASSWORD=$(openssl rand -hex 24)" > .env docker compose up -d

Open http://localhost:7080. The first user to sign up becomes the site admin. Add a GitLab, GitHub or Gitea connection under Site admin → Code host connections, and repositories start cloning and indexing.

Production deployments

docs/install.md is the install guide. For production, use one of these:

Kubernetes (Helm), for larger installs and several repo nodes: install.md → Kubernetes, with an external PostgreSQL and your own secret, size presets and sizing. Every value is in the chart README.
Docker Compose, production layout (compose.production.yaml, one container per role), for one host: install.md → Production layout.

Running either one is covered by the docs on upgrades (Compose, Helm), backups, monitoring and configuration as code.

AI agents (MCP)

/.api/mcp is a Model Context Protocol server. Coding agents search code, read files, find symbols, definitions and references, and read history (log, commits, compare, blame) with the caller's permissions, in output sized for a model's context. Connect an agent in the sidebar gives copy-paste setup for Claude Code, Cursor, VS Code, Codex, Gemini CLI, Zed, JetBrains and others, with a one-click token. For Claude Code:

claude mcp add --transport http sourcegull https://sourcegull.example.com/.api/mcp \

--header "Authorization: Bearer "

Tools and examples: docs/mcp.md.

How it works

One binary, sourcegull, runs in roles: web (UI, APIs, search fan-out), repo (git storage, index shards and search, partitioned across nodes), worker (background jobs) and blob (blob store); sourcegull supervise runs them all in one process. sourcegull executor runs sandboxed jobs in Docker or Kubernetes. PostgreSQL holds the data, job queues, leases and caches; there is no Redis. Each repo node indexes and searches its own repositories; web parses the query, applies permissions, fans it out to the nodes and merges the result streams. Details in docs/architecture.md.

Build from source

Everything runs in Docker; nothing to install but Docker with Compose.

docker compose up -d          # Postgres, Sourcegull built from this checkout, UI dev server

open http://localhost:5173 # UI with hot reload; API on :7080 scripts/dev test # the test suite against the dev Postgres scripts/dev check # rustfmt, clippy -D warnings, UI type check and tests scripts/dev help # e2e tests, benchmarks, a local GitLab with seed data, ...

Alternatives

	Sourcegull	Sourcegraph	Sourcebot	Zoekt	OpenGrok	Hound	GitLab code search
Licence	🟢 Apache-2.0	💰 proprietary	💰 proprietary, free to 5 users	🟢 Apache-2.0	🟢 CDDL-1.0	🟢 MIT	💰 GitLab tiers
Every feature free	🟢	🔴	🔴	🟢	🟢	🟢	🔴
Written in	Rust	Go, TypeScript	TypeScript (Zoekt inside)	Go	Java	Go	Ruby, Go
Indexed regex search	🟢	💰	🟢 to 5 users	🟢	🟢	🟢	💰 default branch only
Unindexed revisions (any branch, tag, commit)	🟢	💰	🔴	🔴	🔴	🔴	🟡 any branch, one project at a time
Structural and BM25 keyword search	🟢	💰	🔴	🔴	🔴	🔴	🔴
Code hosts	🟢 GitLab, GitHub, Gitea	💰 many	🟢 many, to 5 users	🟡 mirror tools	🟡 local checkouts (many VCS)	🟢 git and others	🟢 GitLab only
Precise code navigation (SCIP), cross-repository	🟢	💰	🔴	🔴	🔴	🔴	🟡 within one project
Repository permissions synced from the code host	🟢	💰	💰	🔴	🔴	🔴	🟢 built in
SSO, SCIM, RBAC, audit log	🟢	💰	💰 SSO free to 5 users, rest paid	🔴	🔴	🔴	💰 partly paid
Bulk changes across repositories	🟢	💰	🔴	🔴	🔴	🔴	🔴
Trends, watches, search jobs	🟢	💰	🔴	🔴	🔴	🔴	🔴
MCP server for AI agents	🟢	💰	🟢 to 5 users	🔴	🔴	🔴	🟡 free, cross-project code search paid
Hosted AI assistant	🔴	💰	🟢 to 5 users	🔴	🔴	🔴	💰

🟢 free · 💰 paid · 🟡 incomplete · 🔴 not available

Sourcegraph is the most complete code intelligence platform, self-hosted under a commercial licence.
Sourcebot builds a web UI, an MCP server and an AI assistant on Zoekt. It is closed source since version 6. The free plan stops at 5 users, permission syncing and analytics are in paid plans, and SCIM and audit logs are in the Enterprise plan.
Zoekt is a fast trigram search engine and nothing else. It answers literal queries faster than Sourcegull; Sourcegull indexes faster, needs less disk and answers regexps faster (below).

Benchmark: the same GitLab, one product at a time

Each product indexed the same 1,007 public projects from one GitLab CE 19.4 instance: 7 large repositories at pinned releases (Linux, LLVM, Go, Rust, Kubernetes, GitLab, TensorFlow; 4.4 GB of source) and 1,000 generated repositories with history (0.84 GB). Every product ran alone, from a fresh install, next to GitLab on one host with 6 CPUs and 24 GB of memory.

	All repositories searchable	Peak memory (indexing)	Memory (idle)	Disk	Selective literal	Common literal	Regex	No match

| Sourcegull | 3 min 21 s | 3.7 GB | 2.2 GB | 3.7 GB | 54 / 69 ms (724) | 48 / 54 ms (10

Only the beginning is shown; read the rest in the repo

Sourcegull

What it does

Install

Open Claude’s Connectors page

Click “Add” → “Custom” → “Web” and fill in these 2 fields

Turn it on in a chat

Try it

Open ChatGPT’s add-MCP page on the web

Fill in the name and address

Pick Sourcegull in a chat

Try it

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Open Cursor’s MCP settings file

Open the AI chat in Cursor in Agent mode

Try it

Open VS Code’s MCP settings file

Open the AI chat in VS Code in Agent mode

Try it

Over the web

At a glance

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Discussion

User reviews

Compared with others in Developer toolsi

Common questions

Similar alternatives

GitDiagram

Appllama

Cloudflare MCP

Omnara

Repowise

README from the maker

Fast search, fewer tokens

Everything is free

Ready for production

Quick install

Production deployments

AI agents (MCP)

How it works

Build from source

Alternatives

Benchmark: the same GitLab, one product at a time