GitHub Actions Viewer

A local dashboard for monitoring and triggering GitHub Actions workflows across your repositories.

Quick Start

npx @gtadi/github-actions-viewer

Opens a local web UI where you can monitor workflow runs, pin workflows to a dashboard, and trigger workflow_dispatch workflows.

GitHub PAT Setup

You need a GitHub Personal Access Token (fine-grained) to authenticate.

Creating a fine-grained PAT

1. Go to GitHub Settings > Developer settings > Fine-grained personal access tokens
2. Click Generate new token
3. Set Repository access to the repos you want to monitor
4. Under Repository permissions, grant:

| Permission | Access | Required for | |---|---|---| | Actions | Read and write | Listing workflows, viewing runs, triggering dispatches | | Contents | Read | Reading workflow YAML to extract dispatch input definitions | | Metadata | Read | Automatically included |

5. Click Generate token and copy it

Adding the token

1. Open the app and go to Settings > Auth
2. Paste your PAT and click Save Token

Permissions explained

• Actions: Read and write -- required. Without this, the app cannot list workflows or trigger them.
• Contents: Read -- recommended. Without this, the trigger page cannot show input fields for workflow_dispatch workflows. You can still trigger workflows, but you won't see the expected inputs.

Features

• Dashboard -- monitors pinned workflows with auto-polling
• Workflows -- browse all workflows across configured repos, pin the ones you care about
• Trigger -- trigger workflow_dispatch workflows with input forms
• Views -- group workflows into named collections
• Settings -- manage auth, repos, and views

Development

git clone <repo-url>
cd github-actions-viewer
npm install
npm run dev

Configuration

Config is stored at ~/.github-actions-viewer/config.json. It contains your auth token, configured repos, pinned workflows, views, and poll interval. The token never leaves your machine.