Skip to main content

Chub: high-performance curated docs for AI coding agents

Project description

Chub

The missing context layer for AI-assisted development teams.

Chub is a high-performance CLI + MCP server that serves curated, versioned API documentation to AI coding agents. It is a Rust rewrite of Context Hub with team-first features: shared doc pinning, git-tracked annotations, context profiles, and agent config sync.

Installation

pip install chub

Pre-built wheels are available for:

  • Linux x86_64, ARM64
  • macOS x86_64, Apple Silicon
  • Windows x86_64

Quick Start

# Search for docs
chub search "stripe payments"

# Fetch a doc
chub get openai/chat --lang python

# List all available docs
chub list

# Initialize project for team sharing
chub init

You can also invoke Chub as a Python module:

python -m chub search "stripe"
python -m chub get openai/chat --lang python

Usage

Search and fetch

chub search "stripe"                    # BM25 search
chub search "auth" --limit 5            # limit results
chub get stripe/api --lang python       # fetch a doc
chub get openai/chat --version 4.0      # specific version
chub list                               # list all docs
chub list --json                        # JSON output

Team features

chub init                               # create .chub/ project directory
chub init --from-deps                   # auto-detect dependencies
chub pin openai/chat --lang python      # pin a doc version
chub pins                               # list pinned docs
chub profile use backend                # activate a profile
chub annotate openai/chat "note" --team # team annotation
chub detect --pin                       # auto-pin from deps
chub agent-config generate              # generate CLAUDE.md, .cursorrules

Cache management

chub update                             # refresh cached registry
chub cache status                       # show cache state
chub cache clear                        # clear local cache

MCP Integration

Add to your MCP config (.mcp.json for Claude Code, .cursor/mcp.json for Cursor):

{
  "mcpServers": {
    "chub": {
      "command": "chub",
      "args": ["mcp"]
    }
  }
}

MCP tools: chub_search, chub_get, chub_list, chub_annotate, chub_feedback.

How It Works

This Python package is a thin wrapper around the native Rust binary. When you run chub or python -m chub, it delegates to the platform-specific compiled binary bundled in the wheel. No Python runtime dependencies are required.

Links

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

chub-0.1.7-py3-none-win_amd64.whl (3.9 MB view details)

Uploaded Python 3Windows x86-64

chub-0.1.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.6 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

chub-0.1.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (4.5 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

chub-0.1.7-py3-none-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

chub-0.1.7-py3-none-macosx_10_12_x86_64.whl (4.4 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

Details for the file chub-0.1.7-py3-none-win_amd64.whl.

File metadata

  • Download URL: chub-0.1.7-py3-none-win_amd64.whl
  • Upload date:
  • Size: 3.9 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for chub-0.1.7-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 3a6c7447ff8d870552302b36c60b01f03696efd20797fe93f524ebc8e525e12b
MD5 03fb1308357b380cde3906760d96d3f8
BLAKE2b-256 36c2775d646fe561f3b9ab6735d7108abc364f79f3f7c4634db746a647a9bff4

See more details on using hashes here.

Provenance

The following attestation bundles were made for chub-0.1.7-py3-none-win_amd64.whl:

Publisher: release.yml on nrl-ai/chub

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chub-0.1.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for chub-0.1.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 726a9c153844437e405a54c03b4b34339e7f9e2e8e7eff225c48c6297fb31f36
MD5 f887fa3089625dfd1bfa6ce68d9981ce
BLAKE2b-256 cfba6cdf721c5107e807153b30c00541be958b0eb27ef1d6d4edea94b333b1e7

See more details on using hashes here.

Provenance

The following attestation bundles were made for chub-0.1.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on nrl-ai/chub

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chub-0.1.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for chub-0.1.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 c878225633c9b30503f93b7c56392dae7839901a491623b9977a70bd171c95db
MD5 60c62e4dc9f0624e3222ab51d44c4a83
BLAKE2b-256 f94c73d5996289a73020cab356307e9637c9bcc327223b6f73520f3257792bef

See more details on using hashes here.

Provenance

The following attestation bundles were made for chub-0.1.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on nrl-ai/chub

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chub-0.1.7-py3-none-macosx_11_0_arm64.whl.

File metadata

  • Download URL: chub-0.1.7-py3-none-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 4.3 MB
  • Tags: Python 3, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for chub-0.1.7-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b8a81cc6e5dce4fe0f911150464aeb6fcdd60a3dc8a9b017c4318188d95a72f8
MD5 e867dc630f2db42ff69ad63016546ca0
BLAKE2b-256 8e176dbfc13c8969138b1f41777468480858ca3515c0efe4d145dabbad9f4f5b

See more details on using hashes here.

Provenance

The following attestation bundles were made for chub-0.1.7-py3-none-macosx_11_0_arm64.whl:

Publisher: release.yml on nrl-ai/chub

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chub-0.1.7-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for chub-0.1.7-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 11c29827a846cd2bc5d4a386d654274281f2c61481ada21495870ccf1bdc5a99
MD5 d2ee699b7d910358324f2e82a02f12da
BLAKE2b-256 2f309669bb44f17ea4c29393aa5ec979081144cb3f41e1cab1af523f5651a26d

See more details on using hashes here.

Provenance

The following attestation bundles were made for chub-0.1.7-py3-none-macosx_10_12_x86_64.whl:

Publisher: release.yml on nrl-ai/chub

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page