GitHub PR Workflow Rerun Tools 🚀

A comprehensive toolkit for rerunning failed GitHub Actions workflows on Pull Requests. Available in multiple implementations: Web App, TypeScript, Bash Script, and Interactive CLI.

🎯 Quick Start

# Web App (Best UX) 🌟
npm run start:web

# Interactive CLI
npm run start:interactive

# Bash Script (Fast & Simple)
npm run start:gh

# TypeScript (Full-featured)
npm start:js

📁 Project Structure

src/
├── web/                       # Modern Web Application
│   ├── index.html            # Web UI
│   ├── app.ts                # Frontend TypeScript
│   ├── app.js                # Compiled JavaScript
│   └── styles.css            # Modern CSS with dark/light themes
├── index.ts                   # Original TypeScript implementation
├── index.test.ts             # TypeScript tests
├── rerun-with-gh.sh          # Bash script (GitHub CLI)
├── rerun-with-gh.test.sh     # Bash script tests
├── interactive-cli.ts        # Interactive CLI wrapper
└── interactive-cli.test.ts   # Interactive CLI tests

🔧 Installation

npm install

Prerequisites:

Node.js 18+
GitHub CLI (gh) installed and authenticated: gh auth login (for CLI/Bash versions)

🎮 Usage Options

1. Web Application (Best UX) 🌟

npm run start:web

Features:

✨ Modern responsive web interface
🌙 Dark/Light theme support
🔍 Searchable author selection with auto-complete
📋 Visual PR selection with approval status
⚡ Real-time form validation
💾 Configuration save/load from JSON files
🎯 Auto-loading of authors and PRs
📊 Detailed results display with proper contrast

Web Interface:

Smart form validation with auto-focus on errors
Searchable dropdown for active contributors (last 6 months)
PR status display with emojis (✅ approved, ⏳ pending)
Auto-loading PRs when author is selected
Configuration tips and file management

2. Interactive CLI 💻

npm run rerun

Features:

✨ Beautiful interactive menus
🔧 Configuration wizard
Automatic config saving
🎨 Colorized output

Interactive Menu:

🚀 GitHub PR Workflow Rerun - Interactive CLI
══════════════════════════════════════════════

? What would you like to do?
❯ 🔄 Rerun failed workflows for PR author
  🎯 Rerun specific PR numbers  
  📋 List failed runs (no rerun)
  ⚙️  Configure settings
  💾 Save current configuration
  ❌ Exit

3. Bash Script (Fastest) ⚡

# Use .env.gh configuration
npm run start:gh

# Or direct environment variables
AUTHOR=username DRY_RUN=false src/rerun-with-gh.sh

Features:

🚀 Super fast execution
📦 No dependencies (just gh CLI)
🔧 Environment file support
🎨 Colorized logging

4. TypeScript Implementation (Original) 📝

npm start

Features:

🔍 Full GitHub API integration
📊 Detailed logging with Winston
🧪 Comprehensive test suite
📋 Table formatting

🔄 Method Comparison

Feature	Web App	Interactive CLI	Bash Script	TypeScript
User Experience	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐	⭐⭐
Visual Interface	✅ Modern UI	✅ Menus	❌ Terminal	❌ Terminal
Speed	⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐⭐
Author Selection	✅ Searchable	✅ Interactive	❌ Manual	❌ Manual
PR Selection	✅ Visual + Status	✅ List	❌ All/Manual	❌ All/Manual
Configuration	✅ Save/Load Files	✅ Auto-save	✅ .env files	❌ Env vars only
Theme Support	✅ Dark/Light	❌ Terminal	❌ Terminal	❌ Terminal
Dependencies	Node.js + Browser	Node.js	gh CLI only	Node.js
Best For	Daily use	Setup/Config	Quick scripts	Development

Recommendation: Use the Web App for the best experience, Bash Script for automation/scripts.

⚙️ Configuration

Option A: Environment File (`.env.gh`)

REPO_URL=https://github.com/owner/repo
AUTHOR=username
MODE=workflows
DRY_RUN=true
PR_NUMBERS=123,456

Option B: Environment Variables

AUTHOR=username MODE=jobs DRY_RUN=false npm run start:gh

Option C: Interactive Configuration

npm run rerun
# Select "⚙️ Configure settings"

📝 Configuration Options

Variable	Description	Values	Default
`AUTHOR`	Filter PRs by author	GitHub username	-
`MODE`	Rerun mode	`workflows`, `jobs`	`workflows`
`DRY_RUN`	Preview mode	`true`, `false`	`true`
`REPO_URL`	Target repository	GitHub URL or `owner/repo`	Current repo
`PR_NUMBERS`	Specific PRs	Comma-separated	All PRs

Mode Differences:

workflows: Rerun entire workflow (all jobs)
jobs: Rerun only failed jobs (faster)

🧪 Testing

# Run all tests
npm run test:all

# Individual test suites
npm run test              # TypeScript tests
npm run test:gh           # Bash script tests  
npm run test:interactive  # Interactive CLI tests

Test Coverage:

✅ TypeScript: 9 tests (API integration, workflow logic)
✅ Bash Script: 10 tests (CLI functionality, config loading)
✅ Interactive CLI: 3 tests (module structure)

📖 Examples

Rerun Failed Workflows for Specific Author

# Interactive
npm run rerun
# Select "🔄 Rerun failed workflows for PR author"

# Bash
AUTHOR=myusername DRY_RUN=false npm run start:gh

# TypeScript
AUTHOR=myusername DRY_RUN=false npm start

Rerun Specific PR Numbers

# Interactive
npm run rerun
# Select "🎯 Rerun specific PR numbers"

# Bash
PR_NUMBERS=123,456 DRY_RUN=false npm run start:gh

# Direct
npm run interactive -- --pr-numbers "123,456" --no-interactive

List Failed Runs (No Rerun)

# Interactive
npm run rerun
# Select "📋 List failed runs (no rerun)"

# Bash (dry run)
AUTHOR=username DRY_RUN=true npm run start:gh

🔄 Workflow Comparison

Feature	Interactive CLI	Bash Script	TypeScript
UX	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐
Speed	⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐
Features	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
Setup	⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐
Dependencies	⭐⭐⭐	⭐⭐⭐⭐⭐	⭐⭐

Recommendation:

🎯 New users: Interactive CLI
⚡ Power users: Bash Script
🔬 Developers: TypeScript (for learning GitHub API)

🐛 Troubleshooting

GitHub CLI Not Found

# Install GitHub CLI
brew install gh
# Or visit: https://cli.github.com/

# Authenticate
gh auth login

Permission Denied

chmod +x src/rerun-with-gh.sh
chmod +x src/rerun-with-gh.test.sh

Repository Not Found

# Make sure you have access to the repository
gh repo view owner/repo

# Or specify explicitly
REPO_URL=https://github.com/owner/repo npm run start:gh

🎉 Contributing

Run tests: npm run test:all
Test all implementations:
- Interactive: npm run rerun
- Bash: npm run start:gh
- TypeScript: npm start

📊 Performance

Implementation	Startup Time	Memory	Dependencies
Bash Script	~0.1s	~5MB	`gh` only
Interactive CLI	~1.5s	~25MB	Node.js + packages
TypeScript	~2s	~30MB	Node.js + packages

🏁 Summary

Three ways to rerun failed GitHub workflows:

🎮 Interactive CLI: Best user experience with guided menus
⚡ Bash Script: Fastest execution with GitHub CLI
📝 TypeScript: Full-featured with comprehensive API integration

Choose based on your needs:

Learning: TypeScript implementation
Daily use: Interactive CLI
Automation: Bash script

Happy workflow rerunning! 🚀

processPR(): Main processing logic for individual PRs

Testing

The project uses Node.js built-in testing with ts-node for TypeScript support. Tests cover:

URL parsing for different GitHub formats
Configuration validation
Status and conclusion filtering logic
PR number parsing
Mode enum validation

All functions are exported for testing while maintaining clean module execution.

Operation Modes

Workflows Mode (`MODE=workflows`)

Reruns entire workflow runs that have failed
Good for cases where the entire workflow needs to be restarted
More comprehensive but uses more CI resources

Jobs Mode (`MODE=jobs`)

Reruns only the specific jobs that failed within workflows
More targeted and efficient
Preserves successful job results within the same workflow run

Example Output

[21:21:59] info: Limiting to PR(s): 8212
[21:21:59] info: Working on repo: cardinalops/cardinalops
[21:21:59] info: Mode: RERUN FAILED JOBS
[21:21:59] info: Found 1 open PR(s) to process.
[21:21:59] info: PR #8212: fix: COPS-10604 - MITRE - Exposures - user should not be able to remove prevention products.. (author: nitzcard)

Contributing

The codebase follows TypeScript best practices with:

Enum-based configuration
Proper error handling
Comprehensive logging
Modular function design
Full test coverage

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
.github/chatmodes		.github/chatmodes
src		src
.gitignore		.gitignore
COMPARISON.md		COMPARISON.md
README.md		README.md
debug_test.js		debug_test.js
package-lock.json		package-lock.json
package.json		package.json
rerun-with-gh.sh		rerun-with-gh.sh
simple_test.ts		simple_test.ts
test_simple.js		test_simple.js
tsconfig.json		tsconfig.json
tsconfig.web.json		tsconfig.web.json

Folders and files

Latest commit

History

Repository files navigation

GitHub PR Workflow Rerun Tools 🚀

🎯 Quick Start

📁 Project Structure

🔧 Installation

🎮 Usage Options

1. Web Application (Best UX) 🌟

2. Interactive CLI 💻

3. Bash Script (Fastest) ⚡

4. TypeScript Implementation (Original) 📝

🔄 Method Comparison

⚙️ Configuration

Option A: Environment File (.env.gh)

Option B: Environment Variables

Option C: Interactive Configuration

📝 Configuration Options

Mode Differences:

🧪 Testing

📖 Examples

Rerun Failed Workflows for Specific Author

Rerun Specific PR Numbers

List Failed Runs (No Rerun)

🔄 Workflow Comparison

🐛 Troubleshooting

GitHub CLI Not Found

Permission Denied

Repository Not Found

🎉 Contributing

📊 Performance

🏁 Summary

Testing

Operation Modes

Workflows Mode (MODE=workflows)

Jobs Mode (MODE=jobs)

Example Output

Contributing

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Option A: Environment File (`.env.gh`)

Workflows Mode (`MODE=workflows`)

Jobs Mode (`MODE=jobs`)

Packages