alexei.dolgolyov
5a17fe960d
Clarify the two git-history depth knobs and how to keep indexing fast on repos with thousands of commits: - vex history --depth N — query-time walk, per file (caps latency) - vex index --history-depth N — one-time build, global newest-N (like git log -nN) Added to the setup example, the .vex.toml history comment, and the command reference in vex.md.
Claude Code Facts
Last updated: 2026-06-11
A collection of interesting and useful facts, tips, tools, and guides for working with Claude and Claude Code.
Contents
Claude Code Tools & Extensions
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)
Minimal Gitea Actions workflow: push a v* tag → create a Gitea release with optional RELEASE_NOTES.md. No builds, no artifacts — just a release entry.
CI/CD for Python Apps on Gitea
Reusable reference for building CI pipelines, release automation, and installer packaging for Python apps on Gitea — covering lint/test workflows, cross-compiled Windows builds (embedded Python + NSIS), Linux tarballs, Docker images, and Gitea REST API release management.
Windows Code Signing for Open-Source Projects
Review of code signing options for Windows executables — Azure Trusted Signing ($9.99/mo, immediate SmartScreen trust), SignPath.io (free but GitHub-only), SSL.com, Certum, and self-signed. Includes CI/CD integration examples for Gitea Actions.
Gitea Act Runner — Worker Capacity (TrueNAS)
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
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
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 for the current command set).