Rehoboam

Real-time TUI for monitoring Claude Code agents.

Monitor all your Claude Code sessions from one dashboard. See which agents need attention, which are working, and jump directly to any pane.

Installation

Homebrew (macOS/Linux)

brew tap m-mohamed/rehoboam
brew install rehoboam

Cargo

cargo install rehoboam

From Source

cargo install --git https://github.com/m-mohamed/rehoboam

Quick Start

# Initialize hooks in your project
cd ~/your-project
rehoboam init

# Run
rehoboam

Keybindings

Rehoboam's Loop

Autonomous iteration with fresh sessions per loop. Progress persists, failures evaporate.

In spawn dialog (s):

• Enable Loop Mode
• Set max iterations and stop word
• Rehoboam creates .rehoboam/ directory with state files
• Each iteration spawns a fresh Claude session
• Git checkpoint created between iterations for rollback
• Loop stops on stop word, <promise>COMPLETE</promise> tag, or max iterations

State files in .rehoboam/:

• anchor.md - Task spec (your prompt)
• progress.md - Track completed work
• guardrails.md - Learned constraints (auto-populated from repeated errors)
• state.json - Iteration counter, timing data
• activity.log - Per-iteration timing and outcomes
• session_history.log - State transitions for debugging

Sprites (Remote VMs)

Spawn Claude Code agents in isolated cloud VMs via sprites.dev.

export SPRITES_API_TOKEN="your-token"

How It Works

Claude Code → hooks → Unix socket → Rehoboam TUI

Hooks are configured in .claude/settings.json. Run rehoboam init to set up.

Contributing

We welcome contributions! Rehoboam is built by Claude Code users, for Claude Code users.

• CONTRIBUTING.md - Contribution guidelines
• DEVELOPMENT.md - Local development setup
• ARCHITECTURE.md - Codebase map and design decisions

License

MIT

Test