lazyactions

lazyactions

A lazygit-style TUI for GitHub Actions. Monitor workflows, view logs, and manage runs from your terminal.

Prerequisites

• Go 1.21 or later
• GitHub CLI (gh) installed and authenticated, OR a GitHub token

Installation

From Source

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

The binary will be created at ./bin/lazyactions.

Go Install

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

Authentication

lazyactions uses the following authentication methods (in order of priority):

1. GitHub CLI (Recommended): If you have gh installed and authenticated, no configuration needed.

   gh auth login
   

2. Environment Variable: Set GITHUB_TOKEN with a personal access token.

   export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
   

   Required token scopes: repo, workflow

Usage

Navigate to any directory within a GitHub repository and run:

lazyactions

Or specify a path:

lazyactions /path/to/repo

Keybindings

Development

Build

make build

Run Tests

make test

Run Tests with Coverage

make cover

Lint

make lint

Full CI Che

make ci

Project Structure

lazyactions/
├── cmd/lazyactions/    # Entry point
├── app/                # TUI application (BubbleTea)
├── github/             # GitHub API client
├── auth/               # Authentication (SecureToken)
├── repo/               # Repository detection
└── docs/               # Design documents

License

MIT