Scan Repositories

This skill scans local repository directories and compares with the memory system.

Instructions for Agent

1. Determine Scan Scope

The scan will check:

•Windows: C:\Users\{user}\repos
•WSL/Linux: /home/{user}/repos

On Windows machines, scan both locations to find all repositories.

2. Get Current Machine Context

•Machine identifier: hostname (lowercase)
•OS: Windows/WSL/Linux

3. Call Python Script

Execute the scan_repos.py script:

bash

cd "${CLAUDE_PLUGIN_ROOT}"

# Detect Python command (python3 on Linux, python on Windows)
PYTHON_CMD=$(command -v python3 || command -v python)

# Try to use venv if available, create if needed, skip if venv creation fails
if [ -d "venv" ]; then
  # Activate venv (cross-platform)
  if [ -f "venv/bin/activate" ]; then
    source venv/bin/activate
  elif [ -f "venv/Scripts/activate" ]; then
    source venv/Scripts/activate
  fi
elif $PYTHON_CMD -m venv venv 2>/dev/null; then
  echo "Setting up Python environment (first time)..."
  if [ -f "venv/bin/activate" ]; then
    source venv/bin/activate
  elif [ -f "venv/Scripts/activate" ]; then
    source venv/Scripts/activate
  fi
  pip install -r requirements.txt
else
  echo "Note: Using system Python (venv creation not available)"
fi
# Use python3 on Linux/WSL, python on Windows
$PYTHON_CMD scripts/scan_repos.py scan-repos \
  --config-repo "$YW_CONFIG_REPO_PATH" \
  --mode {mode} \
  --machine {machine}

4. Parse Results

Expected JSON output:

json

{
  "untracked": ["temp-repo", "test-project"],
  "missing": ["old-repo"],
  "scan_paths": ["C:\\Users\\twatana\\repos"],
  "total_local": 15,
  "total_tracked": 14
}

5. Format and Display

Based on mode parameter:

Mode: untracked

code

Found 2 untracked repositories:
- temp-repo
- test-project

These repos exist locally but are not in the memory system.
Would you like to add them with /describe-repo?

Mode: missing

code

Found 1 repository in memory but not found locally:
- old-repo (last seen: 2 weeks ago)

This repo may have been deleted or moved.

Mode: all

code

Repository Scan Results:

Scanned: C:\Users\twatana\repos
- Total local repositories: 15
- Total tracked in memory: 14

Untracked (2):
- temp-repo
- test-project

Missing (1):
- old-repo

Suggestion: Review untracked repos and decide whether to track or clean up.

Example Usage

User: "Scan my repos and show what's not tracked"

Agent:

•Scans C:\Users{user}\repos and /home/{user}/repos
•Calls scan_repos.py with mode="untracked"
•Displays untracked repositories
•Suggests next actions