Replace pip with uv throughout documentation

- Update all package installation commands to use uv
- Update CI workflow to install and use uv
- Update error messages in scripts to recommend uv
- Keep pip only for bootstrapping uv in CI environments

Per project standards: always prefer uv over pip for package management.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: jeremyeder

.github/workflows/ci.yml

@@ -35,8 +35,9 @@ jobs:
 
       - name: Install repomap dependencies
         run: |
-          pip install tree-sitter tree-sitter-python tree-sitter-javascript \
-                      tree-sitter-typescript tree-sitter-go tree-sitter-bash
+          pip install uv
+          uv pip install tree-sitter tree-sitter-python tree-sitter-javascript \
+                         tree-sitter-typescript tree-sitter-go tree-sitter-bash
 
       - name: Validate repomap is current
         run: |

README.md

@@ -27,8 +27,8 @@ git clone https://github.com/ambient-code/reference.git
 cd reference
 
 # Install dependencies
-pip install -r requirements.txt      # Repomap dependencies
-pip install -r requirements-dev.txt  # Doc tooling
+uv pip install -r requirements.txt      # Repomap dependencies
+uv pip install -r requirements-dev.txt  # Doc tooling
 
 # Install pre-commit hooks (includes repomap auto-update)
 pre-commit install

docs/patterns/repomap.md

@@ -12,7 +12,7 @@ This repository includes **complete automation** for repomap management. The rep
 
 ```bash
 # Install dependencies (includes tree-sitter packages)
-pip install -r requirements.txt
+uv pip install -r requirements.txt
 
 # Install pre-commit hooks (includes repomap auto-update)
 pre-commit install
@@ -36,11 +36,11 @@ pre-commit install
 ### Install Dependencies
 
 ```bash
-# Using pip
-pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash
-
-# Using uv (recommended)
+# Recommended method
 uv pip install -r requirements.txt
+
+# Or install individually with uv
+uv pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash
 ```
 
 ## Usage
@@ -169,7 +169,9 @@ jobs:
           python-version: '3.11'
 
       - name: Install dependencies
-        run: pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash
+        run: |
+          pip install uv
+          uv pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash
 
       - name: Generate repomap
         run: python repomap.py . > repomap.txt
@@ -189,7 +191,8 @@ generate_repomap:
   stage: build
   image: python:3.11
   script:
-    - pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash
+    - pip install uv
+    - uv pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash
     - python repomap.py . > repomap.txt
   artifacts:
     paths:
@@ -237,8 +240,9 @@ repomap-validation:
         python-version: '3.11'
     - name: Install repomap dependencies
       run: |
-        pip install tree-sitter tree-sitter-python tree-sitter-javascript \
-                    tree-sitter-typescript tree-sitter-go tree-sitter-bash
+        pip install uv
+        uv pip install tree-sitter tree-sitter-python tree-sitter-javascript \
+                       tree-sitter-typescript tree-sitter-go tree-sitter-bash
     - name: Validate repomap is current
       run: ./scripts/update-repomap.sh --check
 ```
@@ -342,7 +346,7 @@ Potential improvements for future versions:
 **Solution**: Install dependencies
 
 ```bash
-pip install -r requirements.txt
+uv pip install -r requirements.txt
 ```
 
 ### Parse Errors
@@ -395,7 +399,7 @@ See LICENSE file in repository root.
 
 **Quickstart**:
 
-1. Install dependencies: `pip install -r requirements.txt`
+1. Install dependencies: `uv pip install -r requirements.txt`
 2. Install pre-commit hooks: `pre-commit install`
 3. The repomap auto-updates on commits!
 

scripts/update-repomap.sh

@@ -73,7 +73,7 @@ generate_repomap() {
         echo -e "${RED}✗ Failed to generate repository map${NC}" >&2
         echo -e "${YELLOW}$error_output${NC}" >&2
         if echo "$error_output" | grep -q "tree-sitter packages not installed"; then
-            echo -e "${YELLOW}Install dependencies: pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash${NC}" >&2
+            echo -e "${YELLOW}Install dependencies: uv pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash${NC}" >&2
         fi
         rm -f "${REPOMAP_FILE}.new"
         return 1
@@ -97,7 +97,7 @@ check_repomap_current() {
         echo -e "${RED}✗ Failed to generate repomap for comparison${NC}" >&2
         echo -e "${YELLOW}$error_output${NC}" >&2
         if echo "$error_output" | grep -q "tree-sitter packages not installed"; then
-            echo -e "${YELLOW}Install dependencies: pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash${NC}" >&2
+            echo -e "${YELLOW}Install dependencies: uv pip install tree-sitter tree-sitter-python tree-sitter-javascript tree-sitter-typescript tree-sitter-go tree-sitter-bash${NC}" >&2
         fi
         rm -f "${REPOMAP_FILE}.check"
         return 1