Two real failures hit during notify-bridge v0.8.1 release that section 1 and section 10.1 didn't cover: 1. New section 1.1 — backend pytest in a per-run /tmp/venv. Single-package ephemeral runners get away with pip install -e into the toolcache; monorepos on persistent Gitea Act Runners (TrueNAS) hit "error: uninstall-no-record-file" the second time a broken wheel install leaks across runs. Venv per run, fresh site-packages, no leak. 2. New section 10.1.1 — pip wheel --no-deps on hatchling has been observed to produce wheels with METADATA missing the Version field. importlib.metadata.version() returns None and the UI advertises 0.0.0+unknown. Defense-in-depth: also expose __version__ from __init__.py and pick the max of (metadata, __version__, source pyproject) in the resolver. Documented when it's needed and when section 10.1 alone is fine. 3. New section 14 troubleshooting entry — quotes the exact pip error message and points at section 1.1 (prevention) and a one-shot site-packages cleanup recipe (recovery on a stuck runner).
Claude Code Facts
Last updated: 2026-05-16
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) and AST Index (fast code search).
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.