README
¶
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
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_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)
gh auth login
Option 2: Personal Access Token
export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
# Required scopes: repo, workflow
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.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package app provides the TUI application for lazyactions.
|
Package app provides the TUI application for lazyactions. |
|
Package auth provides GitHub authentication functionality.
|
Package auth provides GitHub authentication functionality. |
|
cmd
|
|
|
lazyactions
command
Package main is the entry point for lazyactions.
|
Package main is the entry point for lazyactions. |
|
Package github provides sanitization utilities for log content.
|
Package github provides sanitization utilities for log content. |
|
Package repo provides repository detection and validation functionality.
|
Package repo provides repository detection and validation functionality. |
|
test
|
|
|
integration
Package integration provides integration tests for lazyactions TUI application.
|
Package integration provides integration tests for lazyactions TUI application. |