docs(vex): split vex into its own reference, refresh for v1.16.0

- Add vex.md: install (prebuilt binaries + self-update), GPU/CUDA setup,
  jina-code+CUDA recommendation (CUDA essential, too slow on CPU),
  vex mcp install, full command set (bundle/paths/reachable/diff/history,
  search scope+metadata filters), CLAUDE.md integration, caveats
- Shrink claude-code-tools.md section vex to a blurb + links
- Note v1.16.0 capabilities in the vex-vs-ast-index benchmark (not re-benchmarked)
- README: bump date, index vex.md, refresh vex descriptions
This commit is contained in:
2026-06-11 01:11:26 +03:00
parent cd0d984930
commit 4c3b0188d8
4 changed files with 227 additions and 95 deletions
+7 -3
View File
@@ -1,6 +1,6 @@
# Claude Code Facts
> Last updated: 2026-06-01
> Last updated: 2026-06-11
A collection of interesting and useful facts, tips, tools, and guides for working with Claude and Claude Code.
@@ -8,7 +8,7 @@ A collection of interesting and useful facts, tips, tools, and guides for workin
### [Claude Code Tools & Extensions](claude-code-tools.md)
MCP servers, skills, and plugins that extend Claude Code — including Context7 (library docs), AST Index, and vex (fast code search with semantic embeddings).
MCP servers, skills, and plugins that extend Claude Code — including Context7 (library docs), AST Index, and vex (hybrid code search; summarized here with a link to its full reference).
### [Gitea Release Workflow (Minimal)](gitea-release-workflow.md)
@@ -26,6 +26,10 @@ Review of code signing options for Windows executables — Azure Trusted Signing
How to configure parallel job capacity for Gitea Act Runner on TrueNAS. Covers the `CONFIG_FILE` env var requirement, custom `config.yaml` mount, and capacity tuning.
### [vex — Hybrid Code Search Reference](vex.md)
Full reference for the `vex` code-search tool (current release **v1.16.0**) — install (prebuilt Windows/macOS/Linux binaries + `self-update`, or build-from-source), **GPU / CUDA acceleration** with the `jina-code` embedder recommendation, MCP-server registration (`vex mcp install`), the recommended `.vex.toml`, the complete command set (call graph, git history, scope/metadata search filters), and CLAUDE.md integration.
### [Code Search: vex vs ast-index — Benchmark Notes](code-search-vex-vs-ast-index.md)
Point-in-time benchmark of `vex` and `ast-index` on a real mixed-language repo — indexing footprint, query latency, precision findings, and when to fall back from one to the other. Refreshed for `vex 1.9.1` / `ast-index 3.41.0`, with a summary of what flipped since the previous snapshot.
Point-in-time benchmark of `vex` and `ast-index` on a real mixed-language repo — indexing footprint, query latency, precision findings, and when to fall back from one to the other. Latency/quality tables pinned to `vex 1.9.1` / `ast-index 3.41.0`, with a summary of what flipped since the previous snapshot and a vex 1.16.0 capability-update note (see [vex.md](vex.md) for the current command set).