⚡ Vigil

The PR lifecycle is death by a thousand interrupts. Push code, wait for CI, read reviews, fix nits, push again, update descriptions, fill in verification evidence, respond to comments, request re-review. Repeat until merge or madness.

Vigil watches your pull requests so you don't have to.

It monitors your authored PRs plus incoming review PRs where you are requested, tagged, or matched by repo radar rules, classifies them in real-time, and dispatches AI agents to handle the mechanical work — fixing review feedback, rebasing branches, responding to comments, filling in evidence templates. You stay in flow. Vigil keeps the watch.

Push code
  → Vigil detects new/updated PR
  → Triage agent reads ALL signals (CI, reviews, conflicts, templates)
  → Action agents dispatch IN PARALLEL
    ├── 🔧 Fix patches code from review feedback
    ├── 💬 Respond replies to reviewers, pushes back on scope creep
    ├── 📋 Evidence fills verification sections
    └── 🔀 Rebase resolves conflicts with main
  → Fix pushes commit → triggers new CI → loop continues
  → PR reaches READY → you merge
  → Learning agent captures patterns for next time

Every PR is classified into one of five states:

Six agents. Each does one thing well.

All agents run in-process via the Claude Agent SDK. No subprocesses, no external services, no containers. Git operations are scoped to worktrees for safety.

• Bun >= 1.1.0
• GitHub CLI (gh) — authenticated
• ANTHROPIC_API_KEY environment variable
• (Optional) terminal-notifier for click-to-open notifications on macOS

git clone https://github.com/hyperb1iss/vigil.git
cd vigil
bun install
bun run build
bun run link  # Symlinks to ~/.local/bin/vigil

vigil                                    # All your PRs, all repos
vigil --repo owner/repo                  # Focus on one repo
vigil --repo owner/repo --repo org/lib   # Multiple repos
vigil --mode yolo                        # Auto-execute confident actions
vigil --no-agents                        # Dashboard only, no AI
vigil --demo                             # Mock data for visual testing

Built with Ink and the SilkCircuit Neon design language. Cards, colors, vim motions, mouse support.

Navigation

Controls

Detail View — j/k scroll, Tab pages, a opens actions, o or click opens PR in browser.

Action Panel — 1-9 approve, a approve all, n skip.

🛡️ HITL — The default. Every agent action shows up in the action panel first. You approve with a keypress. Nothing happens without your say-so.

🪄 YOLO — Confident actions auto-execute. Uncertain ones still pause. Destructive operations (force push, merge, close, delete branch) always require confirmation — even in YOLO.

Toggle anytime with y.

Lightweight desktop alerts for the things that actually matter:

Click a notification → opens the PR in your browser. First-poll alerts are suppressed so you don't get blasted on startup.

{
  "notifications": {
    "enabled": true,
    "onCiFailure": true,
    "onBlockingReview": true,
    "onReadyToMerge": true,
    "onNewComment": false
  }
}

Per-repo overrides live in .vigilrc.json. TypeScript repo config execution is currently disabled, so stick to JSON for local overrides.

If you want slower personal projects to surface every incoming PR, set radar.repos[].watchAll: true in your global config.json. Those PRs stay visible at watch tier even without an explicit review request.

{
  "radar": {
    "repos": [
      {
        "repo": "owner/repo",
        "domainRules": [],
        "watchAll": true
      }
    ]
  }
}

The Learning agent captures patterns from every merged PR — reviewer tendencies, common CI failure fixes, response templates. Stored as human-readable markdown. Edit it, seed it, or let it grow.

GraphQL authored-PR discovery
  → Repo-paged detail hydration + incoming radar paging
    → Poller (30s, snapshot diffing)
      → State Machine (5 states)
        → Zustand Store → Ink TUI
        → Orchestrator → Agents (parallel)
          → Desktop notifications

bun run dev          # Watch mode
bun run build        # Bundle to dist/
bun run check        # Typecheck + lint + test
bun run lint:fix     # Auto-fix
bun test             # Run the full test suite
bun run test:coverage
bun run typecheck    # Types only

Contributions welcome! Run bun run check before submitting.

1. Fork it
2. Branch it (git checkout -b feat/amazing-thing)
3. Conventional commit it
4. PR it

Apache 2.0 — use it, extend it, build on it.

<sub>If Vigil is keeping watch, give it a ⭐ or buy me a Monster Ultra Violet ⚡

✦ Built with obsession by Stefanie Jane ✦</sub>