sutra is both an executable binary that can be run, and a library that can be used in Rust programs.
Installing the command-line executable
Assuming you have Rust/Cargo installed , run this command in a terminal:
cargo install sutra
It will make the sutra command available in your PATH if you've allowed the PATH to be modified when installing Rust . cargo uninstall sutra uninstalls.
Adding sutra library as a dependency
Run this command in a terminal, in your project's directory:
cargo add sutra
To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:
sutra = "0.1.3"
The sutra library will be automatically available globally.
Read the sutra library documentation .
Back to the crate overview .
Readme
sutra
A dev environment status dashboard. Monitors a well-known state folder for environment meta and per-unit status files, rendering everything in a native GUI (iced) or TUI (ratatui). On macOS, state transitions trigger system sounds, speech, and native notifications.
Install
cargo install sutra
Usage
sutra # launch GUI (backgrounds by default)
sutra mon --foreground # GUI, attached to terminal
sutra mon --tui # terminal UI
Both interfaces support per-unit and global toggles for sound and notification muting, environment termination, and opening browser ports.
Feature
macOS
Linux
GUI (iced)
yes
yes
TUI (ratatui)
yes
yes
System sounds
yes
--
Speech (TTS)
yes
--
Native notifications
yes
--
Linux/Windows audio and notification support is tracked in #1 .
Features
gui -- iced-based native window (default)
tui -- ratatui terminal interface (default)
Build with only one:
cargo build -- no-default-features -- features tui
License
MIT OR Apache-2.0