claudegoodies
CLAUDE.md

claude-context CLAUDE.md

From zilliztech

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Indexes a codebase into a Milvus vector store and exposes semantic code search as an MCP server, VSCode extension, or library.

Use it when

  • Want an AI coding agent to query code semantically instead of loading whole dirs
  • Need incremental re-indexing on file changes across large repos
  • Building an MCP-based tool that needs code search over a project
  • Want the same indexing engine embedded in VSCode or a Chrome extension

Skip it if

  • Requires a Milvus/Zilliz instance (or a Zilliz account/token) and an embedding provider API key
  • Node must be >=20 <24 with pnpm >=10, monorepo build step required before use
  • Adds a vector-DB + embedding pipeline instead of simple grep/glob search

Facts

Repository
zilliztech/claude-context
Status
Actively maintained
Last commit
Source file
CLAUDE.md

Source preview

The instructions Claude Code reads when this claude.md runs.

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Overview

Claude Context is an MCP plugin that adds semantic code search to AI coding agents. A codebase is split into chunks, embedded, and stored in a Milvus/Zilliz vector database; queries are answered by semantic (hybrid dense + sparse) search instead of loading whole directories into the model's context.

## Monorepo Layout

pnpm workspace (`packages/*`, `examples/*`). Requires Node >=20 <24 and pnpm >=10.

- `packages/core` (`@zilliz/claude-context-core`) — the indexing engine. All real logic lives here; the other packages are thin frontends over it.
- `packages/mcp` (`@zilliz/claude-context-mcp`) — stdio MCP server, the primary product. ESM (`"type": "module"`).
- `packages/vscode-extension` (`semanticcodesearch`) — VSCode extension. Bundled with webpack; stubs out Node-only deps (Milvus gRPC, native AST) in `src/stubs/`.
- `packages/chrome-extension` — browser build; overrides `@zilliz/milvus2-sdk-node` to `false` (no gRPC in browser).
- `examples/basic-usage` — runnable library example.

## Commands

```bash
pnpm install
pnpm build                 # build all packages (examples built last)
pnpm build:core            # build a single package: also build:mcp, build:vscode
pnpm dev                   # watch all; or dev:core / dev:mcp / dev:vscode
pnpm li
View full source on GitHub →

Other claude.md files