claude-code-facts/claude-code-tools.md

Claude Code Tools & Extensions

Useful tools, plugins, and extensions for Claude Code.

MCP Servers

MCP (Model Context Protocol) servers are external processes that provide tools to Claude Code via a standardized protocol. They run alongside your session and extend Claude's capabilities.

Context7

Up-to-date documentation and code examples for any library, available directly in your Claude Code session.

• Website: https://context7.com/

• Setup:

  claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: <YOUR_API_KEY>"
  

• Note: API key can be created for free after signing in at context7.com

code-review-graph

Builds a Tree-sitter–based structural graph of the codebase (callers, callees, imports, tests, blast radius) and exposes it as an MCP server. Lets Claude scope reviews to the minimal affected set instead of scanning whole projects — the project README reports ~8x fewer tokens on code reviews and up to ~49x on daily tasks.

• Repository: https://github.com/tirth8205/code-review-graph

• Setup:

  pip install code-review-graph
  code-review-graph install   # auto-configures Claude Code / Cursor / Windsurf
  

  Then restart the editor and build the graph for the current repo via the build_or_update_graph_tool.

• Languages: 23+ including Python, TypeScript/JavaScript, Go, Rust, Java, plus Jupyter notebooks.

• Key tools: detect_changes, get_review_context, get_impact_radius, get_affected_flows, query_graph, semantic_search_nodes, get_architecture_overview.

VS MCP Server (Visual Studio)

Visual Studio 2022/2026 extension that exposes the IDE itself over MCP — solutions/projects, document I/O, editor navigation, build status, debugging (breakpoints, stepping, variable inspection), error list, and window control. Useful when working on .NET/C++ solutions where Claude Code needs to drive the actual Visual Studio session rather than just edit files on disk.

• Marketplace: https://marketplace.visualstudio.com/items?itemName=CodingWithCalvin.VS-MCPServer
• Setup: Install from Extensions → Manage Extensions in Visual Studio (search "MCP Server"), or download the .vsix. Start via Tools → MCP Server → Start Server (defaults to http://localhost:5050).
• Note: This is a Visual Studio extension, not VS Code — despite the marketplace.visualstudio.com URL, which hosts both.

Skills (Slash Commands)

Skills are a different extension mechanism from MCPs. They are prompt-based extensions invoked via /skill-name commands directly within Claude Code — no external server required.

Installing .skill packages

Skills are distributed as .skill files (ZIP archives containing a SKILL.md and optional scripts).

Manual extraction (works everywhere, including VS Code extension):

# Python one-liner
python -c "import zipfile; zipfile.ZipFile('my-skill.skill').extractall('$HOME/.claude/skills')"

Skills are extracted into ~/.claude/skills/<skill-name>/. They become available in the next Claude Code session.

AST Index

Fast code search skill for Claude Code — find classes, symbols, usages, implementations, and more across large codebases using AST parsing.

• Repository: https://github.com/defendend/Claude-ast-index-search
• Usage: Invoke with /ast-index or related commands like "find class", "search for symbol", etc.

vex

Fast hybrid code search — combines tree-sitter AST parsing, FST symbol lookup, BM25 body search, and optional ONNX semantic embeddings. Ships as a CLI (vex search, vex usages, vex callers, vex similar, vex duplicates, vex pattern, etc.) plus an optional MCP server (vex-mcp) that exposes the same operations to Claude Code as ~17 structured tools. Useful as a peer or replacement for AST Index when you want semantic / concept-level search in addition to exact symbol lookup.

• Repository: https://github.com/tenatarika/vex

• Languages: 18+ via tree-sitter — Python, TypeScript/JavaScript, Go, Rust, Java, Kotlin, C#, Ruby, Swift, C++, PHP, Bash, Lua, CSS, HTML, YAML, TOML, SQL, Markdown.

• Install (Linux/macOS):

  brew tap tenatarika/tap && brew install vex
  

  Latest release also ships prebuilt tarballs for linux-x86_64 and darwin-aarch64.

• Install (Windows — build from source, ~3 min):

  As of v1.5.0 there is no prebuilt Windows binary in the release assets, so a Rust toolchain (≥1.80) is required:

  git clone https://github.com/tenatarika/vex.git "$HOME/Documents/vex"
  cd "$HOME/Documents/vex"
  cargo build --release --workspace
  cp target/release/vex.exe target/release/vex-mcp.exe "$HOME/.cargo/bin/"
  

  ~/.cargo/bin/ (i.e. %USERPROFILE%\.cargo\bin) is already on PATH on any system with cargo installed, so both binaries become globally callable immediately.

• Per-project bootstrap:

  cd <your-project>
  vex init                         # creates .vex.toml
  vex index --path .               # plain index, sub-second, no downloads
  # or, for semantic / concept-level search:
  vex index --path . --semantic    # downloads ~86 MB ONNX model on first run
  

  Recommended .vex.toml for serious use:

  semantic = true        # enable meaning-based search (vex similar, vex duplicates, --semantic queries)
  auto_update = true     # incrementally refresh the index before each search
  

• Register vex-mcp with Claude Code (user scope — available across all projects):

  # Windows
  claude mcp add vex -s user -- "$HOME/.cargo/bin/vex-mcp.exe"
  
  # macOS / Linux
  claude mcp add vex -s user -- "$HOME/.cargo/bin/vex-mcp"
  

  vex-mcp defaults VEX_ROOT to the current working directory, so a single global registration works for every project — individual tool calls can also override per-call via a project_root argument.

• Key commands / MCP tools: search (symbol + semantic), show (full body), usages, callers, callees, implementations, outline, pattern (ast-grep–style structural match), similar (semantic, requires --semantic index), duplicates, status, grep (regex fallback, no index needed), update (incremental reindex).

• Wire it into CLAUDE.md (recommended):

  Installing the binaries and building an index isn't enough — Claude won't reliably prefer vex over Grep/Read unless a CLAUDE.md tells it to.

  Start from upstream, don't duplicate. The vex README maintains a canonical CLAUDE.md snippet — see README.md → "CLAUDE.md Integration". Paste it into your global ~/.claude/CLAUDE.md (applies to every project) or a project-local ./CLAUDE.md (overrides global per repo).

  Then graft on these local additions — they go beyond what upstream covers and are worth keeping wherever you install vex:

  1. MCP server line — add this near the top of the snippet so Claude knows the MCP route exists:

     Equivalent MCP tools are also available via the vex MCP server when registered (claude mcp add vex -s user) — prefer them inside a Claude Code session for cheaper token output; use the Bash CLI from subagents, hooks, and scripts.

  2. Skip-vex rule — add to the Rules block:

     Skip vex for non-code text — config files (YAML/JSON/TOML), docs, log strings, free-form prose — and for files in languages vex doesn't parse. Fall back to the next tool in the priority chain that's actually capable for the case (typically Grep/Glob for free-form text).

  3. Subagent reminder — add to the Rules block:

     Subagents (Plan/Explore/general-purpose) don't inherit project CLAUDE.md or the parent's MCP toolset — explicitly tell them in the prompt to use vex via Bash for code search.

  4. auto_update accuracy fix — upstream says "Run vex update after modifying source files if auto_update is not enabled." With auto_update = true it runs before each search, so during a Claude session the manual update is rarely needed. Reword as:

     Run vex update manually after editing only if auto_update = false; with auto_update = true, vex auto-refreshes before each search.

  5. --semantic cost note — append to the vex index --semantic line in the Indexing block:

     downloads ~86 MB ONNX model on first run, enables vex search --semantic, vex similar, vex duplicates.

  When to put it in global vs project CLAUDE.md:

  • Global (~/.claude/CLAUDE.md) — preferred default once vex-mcp is registered at user scope. Vex becomes the recommendation for every project as soon as the index is built.
  • Project-local (./CLAUDE.md) — for overrides (different fallback chain, monorepo-specific --filter paths, language-specific --kind defaults, or excluding vex on repos where it isn't set up).

• Caveats (as of v1.5.0): vex is a young tool under active development. Known quirks: implementations doesn't detect generic-parameterized subclasses (class Foo(Base[T])); usages is text-flavored and matches inside comments/docstrings; first-time Windows install requires building from source. Verify load-bearing results against ast-index or Grep. The benchmark notes below capture more specific findings on a real repo.

• vex vs AST Index — when each wins: Both tools cover similar ground, but they're not interchangeable. For a point-in-time head-to-head on a real mixed-language repo (Python / Kotlin / TypeScript / JavaScript) with measured latency, quality differences, and version-pinned findings, see code-search-vex-vs-ast-index.md. Headline: keep vex as primary, fall back to ast-index changed --base <branch> for code-review diffs (no vex equivalent) and to ast-index symbol/usages when vex's textual matches are too noisy.

Packaged Skills

Packaged .skill files available in the skills/ directory:

• dolgolyov-dev-facts — Sync local project configuration with the central claude-code-facts knowledge base.
• dolgolyov-git-release-publisher — Generate release notes and push release tags for repos hosted on Gitea or GitHub. Runs pre-release checks (tests / lint / typecheck), pre-flight guards (branch, remote sync, duplicate tag, dirty tree), and post-tag CI watch. Supports RELEASE_NOTES.md overwrite or CHANGELOG.md prepend modes and prerelease versions (-rc.N, -beta.N, -alpha.N).
• feature-planner — Plan and develop complex features using a structured, phase-based workflow with git integration, Markdown plans, review gates, and controlled merging.

Toolkits

Everything Claude Code (ECC)

A comprehensive collection of skills, rules, agents, and hooks for Claude Code.

• Repository: https://github.com/affaan-m/everything-claude-code
• Setup guide: ecc-setup-guide.md