https://github.com/m-mohamed/rehoboam
TUI for monitoring Claude Code agents
https://github.com/m-mohamed/rehoboam
claude-code monitoring rust tui
Last synced: 2 days ago
JSON representation
TUI for monitoring Claude Code agents
- Host: GitHub
- URL: https://github.com/m-mohamed/rehoboam
- Owner: m-mohamed
- License: mit
- Created: 2026-01-08T04:19:16.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-02-05T04:39:56.000Z (14 days ago)
- Last Synced: 2026-02-05T17:25:25.962Z (13 days ago)
- Topics: claude-code, monitoring, rust, tui
- Language: Rust
- Size: 604 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Rehoboam
Real-time TUI for monitoring Claude Code agents.
[](https://crates.io/crates/rehoboam)
[](https://github.com/m-mohamed/rehoboam/actions)
[](LICENSE)
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)
```bash
brew tap m-mohamed/rehoboam
brew install rehoboam
```
### Cargo
```bash
cargo install rehoboam
```
### From Source
```bash
cargo install --git https://github.com/m-mohamed/rehoboam
```
## Quick Start
```bash
# 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, `COMPLETE` 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](https://sprites.dev).
```bash
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](CONTRIBUTING.md) - Contribution guidelines
- [DEVELOPMENT.md](DEVELOPMENT.md) - Local development setup
- [ARCHITECTURE.md](ARCHITECTURE.md) - Codebase map and design decisions
## License
MIT
# Test