Repository navigation
v1.0.0
roo v1.0.0
First stable release. roo is a lightweight process wrapper with a TUI status bar for running, backgrounding, attaching to, and managing long-running commands with automatic log capture.
Features
- Process wrapper: run any command under
roowith a live TUI status bar - Background processes:
roo startruns detached, reattach later withroo attach - Named processes:
--nameflag for easy reference instatus,attach,stop roo topdashboard: live TUI view of running processes, with--globalfor all directories- Status output: human-readable or
--jsonfor scripting - Pause/unpause output streaming from the TUI (
pkey) - Uptime display in the status bar
- Stderr color distinction in attached output
- Safe quit when viewing processes from
top - Empty-state messaging in
topwhen no processes are running
Storage and housekeeping
- Logs stored under
/tmp/roo/<cwd>/mirroring project path hierarchy - 7-day auto-prune of old process directories
- 10 MB cap per log file with rotation
Install
./install.shRequires Node.js. See README for full usage.