jenkins-cli

๐ŸŽ›๏ธ Interactive Explorer

The full-screen TUI explorer โ€” panel layout, key bindings, and focus tricks.

The interactive explorer is a full-screen TUI with three panes: jobs, builds, and logs.

+------------------+------------------+-----------------------------------------+
|      Jobs        |      Builds      |                 Logs                    |
|  (filter live)   | (#  State Dur Age)|  syntax highlight / search / follow     |
+------------------+------------------+-----------------------------------------+
|  Status / Key Hints & Active Filters / Pane Focus Indicator / Help (?)        |
+--------------------------------------------------------------------------------

Launch it with:

jenkins --interactive            # root flag form
jenkins interactive              # explicit subcommand form
jenkins ui my-service            # single-job view (Jobs panel hidden)

The explorer is rendered with Ink and runs in the terminal's alternate screen buffer โ€” it takes over the whole screen while open and restores your scrollback on quit.

โŒจ๏ธ Key Bindings (Core)

KeyActionKeyAction
qQuitfToggle follow
rRefreshFStatus filter (multi-select modal)
1/2/3Focus paneSLog order (newest/oldest first)
โ†/โ†’Cycle panestAuto-refresh toggle
/Contextual search (jobs or logs)aArtifacts overlay
bBuild text filtercClear filters
oFolders-only (jobs)LSet job limit
mBookmark lineMJump to bookmark
e/W/iJump ERROR/WARN/INFOg/GTop / Bottom
lToggle line numberswWord wrap (in logs)
n/NNext / prev search match?Help modal

Builds are always newest-first. F opens a modal to tick/untick which build statuses to display (Space toggles ยท a all ยท n none). Logs default to newest line at the top; S flips the order and jumps the scroll back to the top.

โน๏ธ Build Actions

Actions that change server state are gated with a y / N confirm in the status bar:

KeyAction
xAbort the selected running build (stop / kill / cancel)
TTrigger a new build of the current job (re-run)
wOutside the Logs pane: open the current job/build in your browser

Jenkins has no simple REST endpoint for resume or replay; use T to re-run a job from scratch.

๐ŸŽฏ Focus Tricks

  • Single job mode: jenkins ui my-service (or jenkins interactive --jobs my-service) hides the Jobs panel for more log real estate.
  • Long log lines are clipped to the pane width; press w in the Logs pane to wrap them instead.
  • Emojis auto-replaced in plain terminals (CI, VS Code) โ†’ textual tokens.

On this page