ratspatcher

A terminal UI for dispatching GitHub Actions workflows. Browse repos, fill in workflow inputs, trigger runs, and monitor their status -- all without leaving the terminal.

Built with ratatui and powered by the GitHub CLI.

Features

• Repo management -- Add and remove GitHub repos from a persistent sidebar. Repos are saved to ~/.config/ratspatcher/repos.json.
• Workflow discovery -- Automatically finds dispatchable workflows (workflow_dispatch) and parses their input definitions (string, boolean, choice, environment).
• Dispatch form -- Fill in branch/ref and all workflow inputs through a terminal form with validation.
• Run monitoring -- View the 30 most recent workflow runs in a color-coded table with status, branch, and timestamps.
• Background loading -- Workflow and run data loads in background threads so the UI stays responsive.

Prerequisites

• Rust toolchain (edition 2024)
• GitHub CLI (gh) installed and authenticated

# install gh if needed
brew install gh       # macOS
# or see https://cli.github.com/

# authenticate
gh auth login

Install & Run

cargo build --release
./target/release/ratspatcher

Or run directly during development:

cargo run

Keybindings

General

Navigation

Sidebar

Dispatch Form

Configuration

Repos are persisted at ~/.config/ratspatcher/repos.json as a JSON array:

[
  { "full_name": "owner/repo" }
]

No other configuration is needed. The app manages this file through the Add/Remove repo UI.