Skip to content

borght-dev/BorgDock

Repository files navigation

BorgDock

A lightweight desktop application that monitors GitHub pull requests as a docked sidebar overlay. BorgDock surfaces CI check status, review state, and Claude Code review findings at a glance — and lets you launch automated fixes with one click.

Screenshots

PR Sidebar

All your open PRs in one glance. The sidebar shows every PR grouped by repository with color-coded CI status (green = passing, red = failing, yellow = pending), lines changed, review state, and author avatars. Filter by status tabs — My PRs, Failing, Ready, Reviewing, or Closed — and search across all repos instantly.

PR Sidebar

Expanded PR Card

Click any PR to expand it inline. See the full summary, root cause, fix details, and a test plan — all without leaving the sidebar. Quick-action buttons let you re-run checks, launch a Claude Code fix session, or jump to GitHub. Branch info, file count, and diff stats are shown at a glance.

Expanded PR Card

CI Check Status

Open the detail view to see every CI check for a PR — Analyze, Build & Unit Tests, CodeQL, claude-review — with live pass/fail/pending indicators. One click on "Re-run Checks" or "Fix with Claude" to take action directly. The Overview, Checks, and Reviews tabs let you drill into exactly what you need.

CI Check Status

Claude Code Review

The Reviews tab renders full Claude Code review comments with Markdown formatting. See the overall assessment, categorized issues (bugs, correctness, missing contract alignment), and actionable suggestions — all inline. Approve or request changes directly from BorgDock.

Claude Code Review

Features

  • PR Monitoring — Polls GitHub for open pull requests across configurable repositories, displaying status, reviews, and CI checks in a compact sidebar.

  • Docked Sidebar — A chromeless overlay that pins to the left or right edge of your screen, with auto-hide and hotkey toggle (Ctrl+Win+Shift+G).

  • Focus Tab — A priority-scored "what needs your attention now" view that surfaces ready-to-merge PRs, broken builds on your own PRs, and incoming review requests. One-key Quick Review mode for batch approvals.

  • File Palette (Ctrl+F8) — Fast filename, content (>), and symbol (@) search across your worktrees with live syntax-highlighted preview and a pop-out file viewer window.

  • Syntax Highlighting — Tree-sitter based highlighting across 11 languages (TypeScript, Rust, C#, SQL, and more) in diffs, the file palette preview, and the file viewer.

  • CI Check Details — Inspect failed checks inline with parsed error messages extracted from GitHub Actions logs (supports build errors, test failures, lint warnings, and runtime exceptions).

  • Claude Code Integration — One-click launch of a Claude Code terminal session to automatically fix CI failures. BorgDock finds or creates a git worktree for the PR branch and generates a targeted fix prompt.

  • Claude Review Panel — Surfaces review comments left by Claude Code's bot, grouped by severity, with full Markdown rendering.

  • SQL Query Tool (Ctrl+F10) — Run queries against configured SQL Server connections with Windows Integrated or SQL auth. Execute the highlighted selection only, or the full query.

  • Azure DevOps Work Items (Ctrl+F9) — Browse, edit, and track Azure DevOps work items alongside your PRs, with optional az CLI auto-auth.

  • What's New — In-app release-notes window surfaces new features after each auto-update.

  • Notifications — Windows toast notifications for check status changes, new PRs, and review updates.

  • Floating Badge — A minimal always-on-top badge showing failing PR count when the sidebar is hidden. Five selectable styles:

    Style Preview Description
    Glass Capsule Glass Capsule Frosted glass with pulsing status ring. Subtle, elegant.
    Minimal Notch Minimal Notch Thin colored accent bar + per-PR status pips. Most compact.
    Floating Island Floating Island Author avatars, mini bar chart, ambient glow. Most info-dense.
    Liquid Morph Liquid Morph Animated morphing ring with FIX/OK action tag. Playful.
    Spectral Bar Spectral Bar Two-panel layout with health progress bar. Dashboard-like.
  • Theme Support — Light, dark, and system-following themes.

  • Setup Wizard — First-run wizard that auto-detects gh CLI auth, scans for local GitHub repos, and configures worktree paths.

  • Adaptive Polling — Rate-limit-aware polling with ETag-based conditional requests to minimize GitHub API quota usage.

Requirements

Getting Started

# Clone the repository
git clone https://github.com/your-org/BorgDock.git
cd BorgDock/src/BorgDock.Tauri

# Install dependencies
npm install

# Run in dev mode
npm run tauri dev

On first launch, the setup wizard will guide you through authentication and repository configuration.

Project Structure

src/BorgDock.Tauri/         # Tauri + React + TypeScript application

Tech Stack

  • Tauri for native desktop shell
  • React + TypeScript for UI
  • Rust for backend/system operations

Security Notes

  • Content Security Policy — The Tauri CSP restricts network access to the GitHub API, Azure DevOps, and GitHub avatar CDN. All other external requests are blocked. script-src includes 'wasm-unsafe-eval' so tree-sitter grammar WASMs can instantiate for syntax highlighting.
  • Updater transport — The auto-updater fetches release metadata from the GitHub API (over HTTPS), then serves it to the Tauri updater plugin via a short-lived local HTTP server on 127.0.0.1. The dangerousInsecureTransportProtocol setting is required for this loopback-only server; no data is sent over the network unencrypted.
  • Credentials — GitHub tokens are stored in the OS-level Tauri store (per-user, not in the repo). No secrets are hardcoded in the source.

License

MIT. See LICENSE.

About

No description, website, or topics provided.

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors