Skip to content
Back to search

chunkhound

Your entire engineering context, deeply understood

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/chunkhound/chunkhound with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/chunkhound/chunkhound'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chunkhound--chunkhound/badge.svg)](/listings/chunkhound--chunkhound)

HTML

<a href="/listings/chunkhound--chunkhound"><img src="/api/listings/chunkhound--chunkhound/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

uv tool install chunkhound

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 216 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <a href="https://chunkhound.ai">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)"
  5. srcset="site/public/logo-light.svg">
  6. <img src="site/public/logo.svg"
  7. alt="ChunkHound" width="140">
  8. </picture>
  9. </a>
  10. </p>
  11. <p align="center">
  12. <a href="https://chunkhound.ai">
  13. <picture>
  14. <source media="(prefers-color-scheme: dark)"
  15. srcset="site/public/wordmark-text-dark.svg">
  16. <img src="site/public/wordmark-text.svg"
  17. alt="ChunkHound" width="300">
  18. </picture>
  19. </a>
  20. </p>
  21. <p align="center">
  22. <strong>Your entire engineering context, deeply understood.</strong>
  23. </p>
  24. <p align="center">
  25. Open-source codebase intelligence that gives agents and teams cited context across current code, git history, and technical web research.
  26. </p>
  27. <!-- Keep in sync with site/src/components/Hero.astro amplifier line -->
  28. <p align="center">
  29. Local-first · Dozens of languages & file types · Cited answers · Git history research · Pinpoint web research
  30. </p>
  31. <p align="center">
  32. <a href="https://github.com/chunkhound/chunkhound/actions/workflows/ci.yml"><img src="https://github.com/chunkhound/chunkhound/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  33. <a href="https://pypi.org/project/chunkhound/"><img src="https://img.shields.io/pypi/v/chunkhound.svg" alt="PyPI"></a>
  34. <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
  35. <img src="https://img.shields.io/badge/100%25%20AI-Generated-ff69b4.svg" alt="100% AI Generated">
  36. <a href="https://discord.gg/BAepHEXXnX"><img src="https://img.shields.io/badge/Discord-Join_Community-5865F2?logo=discord&logoColor=white" alt="Discord"></a>
  37. </p>
  38. <p align="center">
  39. <a href="https://chunkhound.ai/docs/getting-started/">Getting Started</a>
  40. ·
  41. <a href="https://chunkhound.ai/docs/configuration/">Configuration</a>
  42. ·
  43. <a href="https://chunkhound.ai/docs/cli-reference/">CLI Reference</a>
  44. </p>
  45. ---
  46. ## Requirements
  47. - **Python 3.10+**
  48. - **uv** — install via `curl -LsSf https://astral.sh/uv/install.sh | sh`
  49. - **API keys** (optional — regex search works without any):
  50. - Embeddings: [VoyageAI](https://dash.voyageai.com/) (recommended) | [OpenAI](https://platform.openai.com/api-keys) | [Ollama](https://ollama.ai/) (local)
  51. - LLM: Claude Code CLI or Codex CLI (no key needed) | [Anthropic](https://console.anthropic.com/) | [OpenAI](https://platform.openai.com/api-keys) | [Grok](https://console.x.ai)
  52. ---
  53. ## AI writes code blind
  54. Agents can generate code, but they still miss the context that makes software safe to change: how behavior flows across files, what changed across a branch or release, and which external constraints matter.
  55. Reviewers, support, and product teams hit the same wall when large PRs, merge conflicts, bugs, and release notes need implementation-backed explanation instead of guesses.
  56. ChunkHound turns current code, git history, and technical web research into cited context before anyone edits, reviews, debugs, or explains software.
  57. ## Deep understanding for four context-heavy jobs
  58. ChunkHound applies codebase understanding to the workflows where missing context hurts most.
  59. ### Research before editing
  60. Give coding agents grounded architecture context, relevant files, recent changes, and external constraints before they write code.
  61. ### Understand large PRs and releases
  62. Turn branch diffs, commit ranges, tags, and specific commits into cited engineering briefs for review, release notes, and changelog drafts.
  63. ### Trace bugs and incidents
  64. Turn symptoms, stack traces, and customer reports into likely code paths, recent changes, and external constraints.
  65. ### Reconcile code with external docs
  66. Pinpoint the technical docs, APIs, issues, and articles your implementation depends on, then connect that external evidence to local code research.
  67. ## What you can ask
  68. ### Ground an agent before edits
  69. ```bash
  70. chunkhound research "How does authentication work?"
  71. chunkhound search "JWT refresh token validation"
  72. chunkhound research "What changed in auth recently?" --last-n 20
  73. ```
  74. ### Understand a large PR or release
  75. ```bash
  76. chunkhound research "Summarize the behavior changes on this branch for reviewers" --commit-range main..HEAD
  77. chunkhound research "Draft changelog bullets for billing since v2.4" --commit-range v2.4..HEAD
  78. chunkhound search "database migration" --commit-hash abc1234
  79. ```
  80. ### Get context before resolving conflicts
  81. ```bash
  82. chunkhound research "Why did auth session handling change on each side?" --commit-range main..feature/auth
  83. chunkhound search "session refresh conflict" --last-n 50
  84. ```
  85. ### Trace a bug with external constraints
  86. ```bash
  87. chunkhound research "why would webhook retries fail?"
  88. chunkhound research "what changed in webhook handling this week?" --last-n 30
  89. chunkhound websearch "Stripe webhook retry schedule"
  90. ```
  91. ### Explain product behavior
  92. ```bash
  93. chunkhound research "What happens when a user cancels a subscription?"
  94. chunkhound research "What changed in billing since v2.4?" --commit-range v2.4..HEAD
  95. ```
  96. ## What powers deep understanding
  97. - **Semantic code search** — find relevant code by meaning, not only exact text
  98. - **Cited code research** — explain behavior across files with source citations
  99. - **Git history research** — ask by last N commits, commit hash, tag, branch, or range to understand large PRs and releases
  100. - **Pinpoint web research** — bring cited external docs, APIs, issues, and articles into the same workflow as local code research
  101. - **Autodoc** — generate shareable docs from code-backed research
  102. - **Local-first indexing** — keep code search and indexing under your control
  103. - **Python, JavaScript, TypeScript, Java, Go, Rust, C/C++, and more** via Tree-sitter
  104. ## Install
  105. ```bash
  106. uv tool install chunkhound
  107. ```
  108. ## Try it
  109. ```bash
  110. chunkhound index .
  111. chunkhound research "How does authentication work?"
  112. ```
  113. Index once, ask a real architecture question, and get a grounded answer with citations. Regex search works without providers. Semantic search requires an embedding provider. Deep research requires an LLM provider and an embedding provider with reranking support; web research uses the same provider stack. Choose local providers for zero-code-egress setups.
  114. For a full configurable setup, create `.chunkhound.json` in your project root:
  115. ```json
  116. {
  117. "embedding": { "provider": "voyageai", "api_key": "your-key" },
  118. "llm": { "provider": "claude-code-cli" }
  119. }
  120. ```
  121. For editor integration, all provider options, and advanced configuration:
  122. **→ [chunkhound.ai/docs/getting-started](https://chunkhound.ai/docs/getting-started/)**
  123. ---
  124. ## Search git history
  125. In addition to searching your indexed codebase, ChunkHound can search
  126. code changes across git history — useful for understanding what changed
  127. in a PR, a release, or since a specific commit.
  128. ```bash
  129. # Last N commits
  130. chunkhound search "authentication changes" --last-n 20
  131. # Changes introduced by a specific commit
  132. chunkhound search "database migration" --commit-hash abc1234
  133. # Custom git range
  134. chunkhound search "API changes" --commit-range v2.0..HEAD
  135. # Deep research over recent changes
  136. chunkhound research "what changed in the auth module?" --last-n 50
  137. ```
  138. > `--vector-source` controls scope: `diff` (default, changed code only),
  139. > `both` (merges diff + DB), `db` (ignore diff).
  140. ## Good fit
  141. ChunkHound is especially useful for:
  142. - large repos and monorepos
  143. - multi-language codebases
  144. - legacy systems
  145. - local-only or security-sensitive environments
  146. - engineering teams that want agents, support, and product questions grounded in the same code index
  147. ## Community
  148. ChunkHound is MIT licensed, open source, and community built.
  149. - [Docs](https://chunkhound.ai/docs/getting-started/)
  150. - [Contributing](https://chunkhound.ai/docs/contributing/)
  151. - [Discord](https://discord.gg/BAepHEXXnX)
  152. - [Issues](https://github.com/chunkhound/chunkhound/issues)
  153. ## License
  154. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.