KaBoom

A VS Code extension for investigating and resolving GitHub issues using Claude Code with MCP tools, git worktrees, and AI-powered workflows.

KaBoom sets up isolated investigation workspaces for each GitHub issue — complete with git worktrees for all your repos, a knowledge base, and a Claude Code session pre-loaded with full context. Pick an issue, and KaBoom handles the rest.

How It Works

1. Pick a GitHub issue from any of your configured repositories
2. KaBoom creates git worktrees across all your repos, branching from the configured base branch
3. A VS Code workspace opens with all worktrees, a knowledge base, and an investigation context folder
4. Claude Code launches in the terminal with full context of the issue and access to all repos via MCP tools
5. Investigate, debug, and fix — Claude has access to Datadog, MongoDB, PostgreSQL, and your codebase

Screenshots

Coming soon

Features

• Git Worktree Management — Creates isolated worktrees (not clones) for every configured repo per investigation, keeping your main branches clean
• GitHub Issue Integration — Paginated issue picker via GitHub CLI with label and state filtering
• Multi-Repo Workspaces — Each investigation workspace includes worktrees from all configured repos
• Claude Code Integration — Automatically launches Claude Code with --add-dir flags for all repos and a pre-written investigation prompt
• MCP Server Configuration — Setup wizard for Datadog, MongoDB, and PostgreSQL MCP servers, written to ~/.claude.json
• Knowledge Base Support — Optional knowledge base repo included in every investigation workspace
• Peacock Color Coding — Each investigation gets a unique color applied to the title bar, activity bar, and status bar
• Dashboard & Sidebar — Webview-based dashboard with investigation cards and a sidebar for quick navigation
• Base Branch Per Repo — Configure main, master, develop, or a custom base branch for each repository

Prerequisites

• VS Code 1.85+
• Claude Code VS Code Extension
• GitHub CLI (gh) — authenticated with gh auth login
• Git 2.15+ (for worktree support)

Getting Started

1. Install the extension — Open VS Code, go to Extensions, and install KaBoom
2. Run the Setup Wizard — KaBoom auto-opens the wizard on first launch, or run KaBoom: Setup Wizard from the command palette
3. Configure your repos — Add repositories with their local path, worktree root, and base branch
4. Configure MCP servers (optional) — Add Datadog, MongoDB, and/or PostgreSQL credentials
5. Start investigating — Click "New Investigation" from the dashboard or sidebar

Configuration

KaBoom stores its configuration in VS Code settings (kaboom.*):

{
  "kaboom.repos": [
    {
      "name": "my-api",
      "url": "https://github.com/org/my-api",
      "localPath": "/Users/you/projects",
      "worktreeRoot": "/Users/you/projects/git-worktrees/my-api",
      "baseBranch": "main"
    }
  ],
  "kaboom.knowledgeBaseRepo": "https://github.com/org/knowledge-base"
}

Commands

How Investigations Work

When you create a new investigation:

1. Worktrees are created in each configured repo with a branch named after the issue (e.g., issue-123-fix-login-bug)
2. An investigation context folder is created at ~/.kaboom/investigation-context/issue-123/ containing:
   • 123-details.md — Full issue details (title, labels, description)
   • CLAUDE.md — Paths to all repo worktrees for Claude Code context
3. A .code-workspace file is generated with all folders, Peacock colors, and a startup task
4. The workspace opens in a new VS Code window with Claude Code ready to go

License

Private — DesignedVR