Skip to content

feat: Implement Satra lightweight TUI process launcher and tracker - #1

Merged
Chintanpatel24 merged 1 commit into
mainfrom
feat/tui-process-launcher
Sep 9, 2026
Merged

Chintanpatel24 merged 1 commit into
mainfrom
feat/tui-process-launcher

Conversation

@Chintanpatel24

Copy link
Copy Markdown
Member

Overview

This PR implements Satra, a lightweight terminal-based process launcher and live session tracker built in Rust using ratatui and crossterm.

Key Features

  • Detached Execution: Commands (e.g., brave, thunar) launch in the background using setsid and Stdio::null(), keeping the input prompt instantly available for further commands.
  • Session Tracking: Active processes are tracked with live status dots (● green for running, red for exited), PID, and real-time uptime counters.
  • TUI Navigation:
    • Tab: Seamlessly switch focus between input prompt and process list.
    • ↑ / ↓: Navigate list when focused.
    • Enter: Open Session Detail popup or launch command.
    • ESC: Return focus to input bar.
  • Session Detail Panel:
    • [k]: Kill process.
    • [r]: Restart process.
    • [d]: Delete from list (terminates if running).
    • [q] / [ESC]: Close detail panel.
  • Auto-Cleanup: Exited processes display their exit status code and are automatically cleaned up after 5 minutes.
  • Process Independence: Quitting Satra (Ctrl+C) leaves spawned applications running detached.
  • One-Liner Install Script: install.sh detects system architecture (x86_64, aarch64) and installs to ~/.local/bin/satra.
  • CI / Release Workflows: GitHub Actions for automated linting, unit testing, and multi-architecture binary release builds.

Verification

  • cargo fmt --check: Passed
  • cargo clippy -- -D warnings: Passed (0 warnings)
  • cargo test: All 6 unit tests passed
  • cargo build --release: Built successfully

- Launch detached background processes via setsid
- Interactive Ratatui TUI with live session monitoring
- Tab-based focus navigation between input bar and session list
- Session Detail popup with process inspection, Kill, Restart, and Delete actions
- Auto-cleanup for terminated processes after 5 minutes
- Shell install script with architecture detection (x86_64, aarch64)
- Unit tests and GitHub Actions CI/Release workflows
Copilot AI lite review requested due to automatic review settings September 9, 2026 18:58

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@Chintanpatel24
Chintanpatel24 merged commit bab235c into main Sep 9, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants