rehoboam
| Crates.io | rehoboam |
| lib.rs | rehoboam |
| version | 0.9.12 |
| created_at | 2026-01-13 00:56:01.577833+00 |
| updated_at | 2026-01-24 23:54:28.203558+00 |
| description | Real-time observability TUI for Claude Code agents - tracks all, predicts needs |
| homepage | https://github.com/m-mohamed/rehoboam |
| repository | https://github.com/m-mohamed/rehoboam |
| max_upload_size | |
| id | 2039116 |
| size | 722,171 |
m9d5m (m-mohamed)
documentation
README
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
| Key | Action |
|---|---|
h/l |
Navigate columns |
j/k |
Navigate agents |
Enter |
Jump to agent's tmux pane |
y/n |
Approve/reject permission |
c |
Custom input to agent |
s |
Spawn new agent |
Space |
Toggle selection |
Y/N |
Bulk approve/reject |
K |
Kill selected agents |
X/R |
Cancel/restart loop |
? |
Help |
q |
Quit |
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 workguardrails.md- Learned constraints (auto-populated from repeated errors)state.json- Iteration counter, timing dataactivity.log- Per-iteration timing and outcomessession_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"
| Key | Action |
|---|---|
Space |
Toggle sprite mode (in spawn dialog) |
c |
Create checkpoint |
R |
Restore checkpoint |
t |
Checkpoint timeline |
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