action-watch

A terminal UI for monitoring GitHub Actions workflows in real-time.

Features

• Real-time monitoring - Auto-refreshes every 10 seconds (configurable)
• Tree view - Expand workflows to see individual jobs with animated spinners
• Log viewer - View job logs in a split pane with syntax highlighting
• Job tabs - Switch between jobs with ←/→ arrow keys to view each job's logs (cached for instant switching)
• Search logs - Search through logs with /, navigate with n/N
• Workflow actions - Cancel running workflows or rerun failed ones
• Local & global views - Toggle between current repo and all your repos
• Tmux integration - TPM plugin with popup window
• Keyboard navigation - Full TUI with vim-style keybindings

Installation

Tmux Plugin Manager (TPM)

Add to your ~/.tmux.conf:

set -g @plugin 'jspanos/action-watch'

Then press prefix + I to install.

The plugin will auto-build the binary if Go is installed, or you can install the binary separately.

Go

go install github.com/jspanos/action-watch/cmd/action-watch@latest

From source

git clone https://github.com/jspanos/action-watch.git
cd action-watch
make install

Download binary

Download the latest release from the releases page.

Requirements

• GitHub CLI (gh) must be installed and authenticated

# Install gh
brew install gh

# Authenticate
gh auth login

Usage

# In a git repository - shows workflows for that repo
action-watch

# Show workflows from all your repositories
action-watch --all

# Custom refresh interval (default: 10s)
action-watch --refresh 5s

# Disable auto-refresh
action-watch --refresh 0

Keyboard shortcuts

Workflow List

Key	Action
↑/k	Move up
↓/j	Move down
Enter/Space	Expand/collapse workflow jobs
l	View logs for selected workflow
c	Cancel running/queued workflow
R	Rerun workflow
a	Toggle between local repo and all repos
r	Manual refresh
q/Esc	Quit

Log Viewer

Key	Action
←/h	Previous job tab
→/l	Next job tab
Tab	Switch focus between workflow list and logs
↑/k	Scroll up
↓/j	Scroll down
g	Go to top
G	Go to bottom
Ctrl+u/PgUp	Half page up
Ctrl+d/PgDn	Half page down
/	Search logs
n	Next search match
N	Previous search match
q/Esc	Close log viewer

Note: Logs are only available for completed jobs. In-progress jobs will show a message indicating logs are not yet available. Logs are cached per session for instant switching between job tabs.

Log Syntax Highlighting

Logs are automatically colorized:

• 🔴 Red - Errors, failures, exceptions
• 🟡 Yellow - Warnings
• 🟢 Green - Success, passed, complete
• 🔵 Cyan - Section headers

Tmux Plugin

The tmux plugin shows workflows in a popup window. Press prefix + g to open.

Installation via TPM

# In ~/.tmux.conf
set -g @plugin 'jspanos/action-watch'

Manual installation

# In ~/.tmux.conf
run-shell /path/to/action-watch/action-watch.tmux

Configuration

Add these options to ~/.tmux.conf before the plugin line:

# Change keybinding (default: g)
set -g @action-watch-key "g"

# Show all repos by default (default: false)
set -g @action-watch-all "false"

# Popup dimensions
set -g @action-watch-width "80%"
set -g @action-watch-height "60%"

CLI Options

Usage: action-watch [options]

Options:
  --all           Show actions from all your repositories
  --limit N       Maximum number of workflow runs to display (default: 15)
  --repo-limit N  Maximum number of repos to check with --all (default: 10)
  --refresh D     Auto-refresh interval, e.g., 10s, 1m (default: 10s, 0 to disable)

License

MIT License - see LICENSE for details.