uv-doc

AI Knowledge Base for uv, the extremely fast Python package and project manager written in Rust.

Contents

• src/ — Markdown source files mirrored from astral-sh/uv (docs/), plus the generated reference/{cli,settings,environment}.md; the version-tracked baseline the cards are built from
• cards/ — Knowledge Cards (YAML front-matter + Markdown), one file per topic, organized by category: commands, concepts, projects, dependencies, configuration, python, tools, scripts, pip, build-publish, integrations, troubleshooting
• sync-docs.sh — script to pull the latest docs from upstream into src/
• docs/ai-instructions.md — source-of-truth instructions for AI agents working in this repo

Usage

Cards are designed for direct context injection into AI assistants (Claude Code, Copilot, Cursor) and RAG/vector-search pipelines. Loaded by the uv Claude Code skill.

Cards are generated by AI agents from the src/ mirror — see docs/ai-instructions.md for the authoritative source list and generation rules.

To refresh the source docs from upstream:

./sync-docs.sh

sync-docs.sh mirrors every committed Markdown doc, then best-effort generates the CLI, settings, and environment-variable reference pages via uv's cargo dev generate-all (requires cargo; those three files are skipped with a warning if it is unavailable).