github-actions

# 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

```bash
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