maintainer-barlisted

# MaintainerBar — Maintainer Menu Bar Skill ## Overview MaintainerBar is a native macOS SwiftUI menu bar app for GitHub repo maintenance. It's backed by **ghcrawl** (local SQLite + OpenAI embeddings) for issue/PR clustering and semantic search. **Repo:** `~/Documents/GitHub/OpenKnots/MaintainerBar` **Stack:** SwiftUI (Swift Package Manager), macOS 14+ **Backend:** ghcrawl CLI (JSON mode) + GitHub API via `gh` **Host:** MB Black (macOS node) ## Prerequisites - ghcrawl installed: `~/.nvm/versions/node/v24.13.0/bin/ghcrawl` - Wrapper: `~/.local/bin/ghcrawl-op` (injects GitHub token via `gh auth` + OpenAI key via 1Password) - Xcode 26+ / Swift 6.0+ - `gh` CLI authenticated - `op` CLI (1Password) for OpenAI key ## Build & Run ```bash # Build cd ~/Documents/GitHub/OpenKnots/MaintainerBar swift build # Run (debug) swift run MaintainerBar # Run built binary directly .build/debug/MaintainerBar ``` ## ghcrawl Operations (via wrapper) All ghcrawl commands should use the `ghcrawl-op` wrapper or inject env vars: ```bash # Refresh a repo (sync + embed + cluster) ~/.local/bin/ghcrawl-op refresh openclaw/openclaw # List clusters (JSON) ~/.local/bin/ghcrawl-op clusters openclaw/openclaw --min-size 2 --limit 30 --json # Semantic search ~/.local/bin/ghcrawl-op search openclaw/openclaw --query "download stalls" --json # Cluster detail ~/.local/bin/ghcrawl-op cluster-detail openclaw/openclaw --id 123 --json # Specific threads ~/.local/bin/ghcrawl-op threads openclaw/openclaw --num