A terminal UI for QUADS bare-metal infrastructure scheduling, built with Rust, ratatui, and crossterm.

• Multi-server management with saved credentials
• Host browsing with status filters and fuzzy search
• Self-schedule workflow: select hosts, pick or create assignments, schedule in bulk
• Assignment and cloud management with mine/all views
• Auto-refresh and manual refresh
• Single-instance enforcement (only one copy runs at a time)

curl -fsSL https://raw.githubusercontent.com/NewtonChutney/quads-tui/main/script/install.sh | bash

This downloads the latest release binary to ~/.local/bin/quads-tui.

To install to a custom location:

INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/NewtonChutney/quads-tui/main/script/install.sh | bash

If you have cargo-binstall installed:

cargo binstall --git https://github.com/NewtonChutney/quads-tui quads-tui

Pre-built binaries are available on the Releases page for:

• Linux x86_64
• Linux aarch64
• macOS aarch64 (Apple Silicon)
• Windows x86_64

Requires Rust 1.85+ (edition 2024).

git clone https://github.com/NewtonChutney/quads-tui.git
cd quads-tui
cargo build --release

The binary will be at target/release/quads-tui.

quads-tui
# or from source
./target/release/quads-tui

Check version:

quads-tui --version

On first run, add a server from the Dashboard with n, then connect with Enter.

Config is stored at ~/.config/quads/quads-tui.toml:

default_server = "my-quads"

[servers.my-quads]
url = "https://quads.example.com"
username = "user@example.com"
password = "..."
verify_ssl = true

Logs are written to ~/.config/quads/quads-tui.log (overwritten each launch).

Default log level is Info. To enable debug logging, set the RUST_LOG environment variable:

RUST_LOG=debug cargo run

To watch logs while the app is running:

tail -f ~/.config/quads/quads-tui.log

1. Fork the repo and create a feature branch
2. Make your changes
3. Run cargo build and cargo clippy to check for errors and warnings
4. Test against a QUADS server (or mock one)
5. Submit a pull request with a description of the changes

src/
  main.rs           - Entry point, key handling, async task management
  app.rs            - App state, screen/popup enums, filtering logic
  config.rs         - Config file read/write
  event.rs          - Terminal event polling
  session.rs        - Multi-session manager with cached data
  update.rs         - Version checking via GitHub releases API
  api/
    endpoints.rs    - HTTP client for QUADS v3 API
    models.rs       - Serde structs for API responses
  ui/
    mod.rs          - Top-level render dispatch
    dashboard.rs    - Server list and summary stats
    hosts.rs        - Hosts table
    assignments.rs  - Assignment sidebar + detail pane
    clouds.rs       - Clouds table
    widgets.rs      - Help bar, popups, shared UI components

This project is licensed under the MIT License.