4c3b0188d8
- 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
36 lines
2.5 KiB
Markdown
36 lines
2.5 KiB
Markdown
# 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](claude-code-tools.md)
|
|
|
|
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)
|
|
|
|
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](gitea-python-ci-cd.md)
|
|
|
|
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](windows-code-signing.md)
|
|
|
|
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)](gitea-runner.md)
|
|
|
|
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. 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).
|