Lazyactions

<div align="center"> <img src="assets/logo.svg" alt="lazyactions logo" width="120" height="120">

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

</div>

---

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.