Broomy

Broomy is a desktop command center for AI coding agents, enabling developers to run and monitor multiple AI coding agents (such as Claude Code, Aider, Codex, Gemini CLI) side-by-side in a single window.

Core Capabilities#

• Multi-Agent Session Management: Run multiple AI coding agent sessions simultaneously in one window with side-by-side operation
• Automatic Agent Status Detection: Real-time status identification by parsing terminal output — working (green), idle (gray), needs input (red), new activity (blue dot), with completion notifications
• Embedded Terminal: Interactive terminal based on xterm.js + PTY, including agent terminal and user terminal (multi-tab support)
• File Browser & Editor: Monaco Editor integration for file tree browsing, code editing, and diff viewing
• Deep Git Integration: Branch tracking, staging, commit, push, worktree support
• GitHub Collaboration: View assigned Issues, PR status, manage code review comments
• AI-Assisted Code Review: AI helps understand changes, highlights potential issues, click to jump to diff (specific model undisclosed)

Workspace & Panel System#

• Profiles Workspaces: Isolated workspaces where each Profile has independent sessions, agents, and repo configs, with support for opening in separate windows
• Six-Panel Layout: Sessions (session list), Explorer (file tree + source control), File Viewer (editor + diff), Agent Terminal, User Terminal, Settings
• Customizable Panels: Based on PanelRegistry pattern, panels can be switched, reordered, and extended

Privacy & Local-First#

Fully local operation with no cloud services, no account requirements, and no telemetry. All code and session data remain on the local machine.

Architecture Overview#

Standard Electron three-process architecture:

• Main Process (Node.js): node-pty, simple-git, gh CLI — handles PTY management, Git operations, filesystem I/O, config persistence, Profile management, Worker thread pool
• Preload (Context Bridge): Exposes IPC interfaces including window.pty / window.git / window.fs / window.config / window.gh / window.profiles
• Renderer (React): 6 Zustand stores (sessions, agents, repos, profiles, errors, tutorial), xterm.js, Monaco Editor

Agent status detection works by parsing PTY terminal output streams and matching specific patterns to infer agent state, without relying on agent APIs.

Installation & Development#

Prerequisites: Node.js 18+, pnpm (mandatory, npm/yarn not supported).

git clone https://github.com/Broomy-ai/broomy.git
cd broomy
pnpm install
pnpm dev

Dev mode auto-opens the app with hot reload, using separate config at ~/.broomy/profiles/default/config.dev.json, with a yellow "DEV" badge in the title bar.

Build: pnpm dist (macOS packaging), pnpm start (run packaged app).

Pre-built downloads: GitHub Releases v1.0.0, currently macOS only. Windows/Linux marked "coming soon" with no specific timeline.

Config File Structure#

~/.broomy/
├── profiles.json
├── profiles/
│   ├── default/
│   │   ├── config.json
│   │   ├── config.dev.json
│   │   └── init-scripts/
│   └── <profile-id>/

Keyboard Shortcuts#

• Cmd+1-6: Switch between six panels
• Cmd+Shift+C: Copy terminal content and session summary

Common Issues#

• posix_spawnp failed → Run npx @electron/rebuild
• Blank screen → Check DevTools console, ensure preload script is in CommonJS format

Unconfirmed Information#

• Windows/Linux support timeline not announced
• Full list of supported agents has no official compatibility matrix; claims "any terminal agent works"
• No npm/brew package manager installation available
• Specific LLM provider or model for AI code review not disclosed
• Developer/team background information missing
• Third-party panel extension development guide not yet published