github-actions

A deep GitHub Actions integration plugin for Anvil that puts your entire CI/CD pipeline at your fingertips. Trigger workflows, monitor run status, stream logs, manage repository secrets, and generate complete workflow YAML files — all without leaving Anvil.

What It Does

github-actions provides bidirectional integration with GitHub's Actions API:

• Workflow triggering: Manually trigger any workflow_dispatch-enabled workflow with custom inputs
• Run monitoring: Check status of running and completed workflow runs with live status updates
• Log streaming: Fetch and display job logs with step-level detail and failure highlighting
• Artifact management: List, download, and inspect workflow artifacts
• Secret management: Create, update, and delete repository and environment secrets securely
• YAML generation: Generate complete, production-ready workflow files for common patterns (test, build, deploy, release, security scan)
• Failure analysis: Analyze failed runs and suggest fixes based on log output
• Cache management: View and purge GitHub Actions cache entries

Installation

anvil plugin install github-actions

Setup

1. Generate a GitHub Personal Access Token (classic) or fine-grained token with repo, workflow, and secrets scopes
2. Configure the plugin:

/gh-actions configure --token ghp_XXXXXXXXXXXX --owner myorg --repo myrepo

Usage

Check Recent Workflow Runs

/gh-actions runs

Trigger a Workflow

/gh-actions trigger deploy.yml --ref main --input environment=production

View Logs for a Failed Run

/gh-actions logs 12345678

Generate a CI Workflow

/gh-actions generate --type ci --language typescript --test-cmd "npm test"

Generate a Release Workflow

/gh-actions generate --type release --registry npm

Set a Repository Secret

/gh-actions secret set DEPLOY_KEY --value "$(cat ~/.ssh/id_rsa)"

Configuration Options

Option	Description	Default
--token	GitHub PAT	env: GITHUB_TOKEN
--owner	Repository owner	auto-detect from git remote
--repo	Repository name	auto-detect from git remote
--branch	Default branch for triggers	main

Requirements

• GitHub Personal Access Token with workflow permissions
• Git repository with a GitHub remote configured