A lazygit-style TUI for GitHub Actions
Monitor workflows, view logs, trigger runs, and manage GitHub Actions — all from your terminal.
Features • Installation • Usage • Keybindings • Contributing
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_dispatchworkflows - 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)
Option 2: Personal Access Token
export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx # Required scopes: repo, workflow
Note: GitHub Enterprise is not currently supported. Only
github.comrepositories 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.
