Repository navigation
Add a terminal dashboard for pools and runners - #26
Merged
Merged
Conversation
runnerctl tui shows every pool with its runner counts and the selected pool's configuration and runners, refreshing every second. From it you can start, stop (drain or force, both confirmed), and scale the selected pool, follow a runner's logs, and run doctor checks. It works over SSH, where most Docker hosts are managed. The dashboard is another control-channel client and sends the same requests as the CLI. Periodic refreshes only talk to a running manager, so the dashboard never holds the manager lock while the manager starts; saved state is read only when the dashboard opens, on r, and after a change. Runner log output is stripped of escape sequences and control characters before it is drawn. ratatui 0.29 keeps the crate's Rust 1.85 minimum; 0.30.x needs 1.86 or later.
Merged
clroot
added a commit
that referenced
this pull request
Nov 16, 2026
Publishes the runnerctl tui terminal dashboard (#26).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
Watching pools means rerunning
runnerctl status, and acting on what you see means typing a separate command with the pool name. A desktop GUI would not help much: most Docker hosts are servers reached over SSH.Change
runnerctl tuiopens a terminal dashboard (ratatui).status, and the selected pool's scope, image, labels, group, error, and runners with drain notes. Refreshes every second.sstart,xstop (drain),Xforce stop (both confirmed),+/-scale,l/Enter runner logs (follows output, stays in place when scrolled up),ddoctor,rrefresh,?help,qquit.r, and after a change, and the header says when the manager is stopped.runnerctl status.ratatui = "0.29"keepsrust-version = "1.85"; 0.30.x needs 1.86 or later. crossterm comes through ratatui's re-export.Verification
cargo fmt --check,cargo clippy --all-targets --locked -- -D warnings,cargo test --locked: pass. Adds 8 unit tests (key handling, refresh behavior, log scrolling, escape stripping, rendering withTestBackend) and a CLI test for the non-terminal error.runnerctl managerrunning (live status over the socket).🤖 Generated with Claude Code