Skip to content

Lazygit-style TUI for GitHub Actions — monitor, trigger, and manage workflows from your terminal

License

Notifications You must be signed in to change notification settings

nnnkkk7/lazyactions

Repository files navigation

lazyactions logo

A lazygit-style TUI for GitHub Actions

CI Go Version Go Report Card License

Monitor workflows, view logs, trigger runs, and manage GitHub Actions — all from your terminal.

lazyactions demo

FeaturesInstallationUsageKeybindingsContributing


Why lazyactions?

Inspired by lazygit and lazydocker.

Tired of switching between your terminal and browser to check CI status? lazyactions brings GitHub Actions to your terminal with a familiar lazygit-style interface.

Features

  • Browse & Monitor — View workflows and runs with real-time status updates
  • View Logs — Stream job logs directly in the terminal
  • Trigger Workflows — Start workflow_dispatch workflows
  • Cancel & Rerun — Stop running workflows or rerun failed jobs
  • Filter — Quickly find workflows and runs with fuzzy search
  • Copy URLs — Yank workflow/run URLs to clipboard
  • Keyboard & Mouse — Vim-style keys and mouse support for navigation

Installation

Homebrew (Recommended)

brew install nnnkkk7/tap/lazyactions

Using Go

Requires Go 1.24+

go install github.com/nnnkkk7/lazyactions/cmd/lazyactions@latest

From Source

Requires Go 1.24+

git clone https://github.com/nnnkkk7/lazyactions.git
cd lazyactions
make build
# Binary: ./bin/lazyactions

Authentication

Option 1: GitHub CLI (Recommended)

gh auth login

Option 2: Personal Access Token

export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
# Required scopes: repo, workflow

Note: GitHub Enterprise is not currently supported. Only github.com repositories are supported at this time.

Usage

# Run in any git repository
lazyactions

# Or specify a path
lazyactions /path/to/repo

Keybindings

Navigation

Key Action
j / k Move between panels
/ Move up/down in list
h / Previous pane
l / Next pane
Tab / Shift+Tab Cycle panes
1 Info tab
2 Logs tab

Actions

Key Action
t Trigger workflow
c Cancel run
r Rerun workflow
R Rerun failed jobs only
y Copy URL to clipboard

General

Key Action
/ Filter mode
Ctrl+r Refresh all data
L Toggle fullscreen log
? Show help
Esc Back / Clear error
q Quit

Mouse

Action Description
Click Select item / Switch pane
Scroll Navigate lists and logs

Development

make build      # Build binary
make test       # Run all tests
make lint       # Run linter
make ci         # Full CI check

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE for details.

Support

If you find lazyactions useful, please consider giving it a star on GitHub! It helps others discover the project and motivates continued development.

Star on GitHub

About

Lazygit-style TUI for GitHub Actions — monitor, trigger, and manage workflows from your terminal

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •