https://github.com/skylarmb/composer_tui
A terminal-based tool for orchestrating multiple parallel AI coding agents, using git worktrees to isolate each agent's work.
https://github.com/skylarmb/composer_tui
Last synced: 4 months ago
JSON representation
A terminal-based tool for orchestrating multiple parallel AI coding agents, using git worktrees to isolate each agent's work.
- Host: GitHub
- URL: https://github.com/skylarmb/composer_tui
- Owner: skylarmb
- Created: 2026-01-29T20:59:02.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-04-01T22:14:29.000Z (4 months ago)
- Last Synced: 2026-04-02T05:33:48.226Z (4 months ago)
- Language: Rust
- Homepage:
- Size: 186 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 39
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# composer_tui
A terminal-based tool for orchestrating multiple parallel AI coding agents, using git worktrees to isolate each agent's work.
Built with Rust and [ratatui](https://ratatui.rs/).
## For Agents
Before starting work, read these docs:
1. **[docs/DESIGN.md](docs/DESIGN.md)** - Architecture, data model, and UI layout
2. **[docs/IMPLEMENTATION_PLAN_V3.md](docs/IMPLEMENTATION_PLAN_V3.md)** - Phased implementation with success criteria
If continuing from a previous phase, also read the relevant handoff doc in `.context/` (e.g. `.context/handoff-phase-15.md`).
### Phase workflow
1. Read the implementation plan and the previous phase's handoff doc.
2. Implement the phase, writing tests for all new functionality.
3. Verify your work passes all checks before considering the phase complete:
```bash
direnv exec . cargo fmt # Format code
direnv exec . cargo clippy # Lint (must be warning-free)
direnv exec . cargo test # All tests must pass
```
4. Write a handoff doc at `.context/handoff-phase-.md` summarizing:
- What was implemented
- Files changed
- Test summary (count, any notable coverage)
- Any decisions or gotchas for the next phase
5. Commit and push your changes.
## Development
Commands run through direnv to ensure correct environment:
```bash
direnv exec . cargo build # Build
direnv exec . cargo run # Run
direnv exec . cargo test # Test
direnv exec . cargo clippy # Lint
direnv exec . cargo fmt # Format
```
## Project Status
See `docs/IMPLEMENTATION_PLAN_V3.md` for current phase and progress.