NAME

ghgen - GitHub Actions workflow generator and analyzer

SYNOPSIS

ghgen generate --auto
ghgen generate --type=perl [--output=FILE]
ghgen generate --type=perl --customize
ghgen generate --interactive
ghgen generate --list

ghgen analyze
ghgen analyze --fix

ghgen --help
ghgen --version

DESCRIPTION

ghgen helps you create and optimize GitHub Actions workflows.

COMMANDS

generate

Generate a new GitHub Actions workflow.

ghgen generate --auto
ghgen generate --type=perl
ghgen generate --type=perl --customize
ghgen generate --type=node --output=custom.yml
ghgen generate --interactive
ghgen generate --list

Options:

--auto, -a			Auto-detect project type and prompt for confirmation
--type, -t TYPE	   Project type (perl, node, python, rust, go, ruby, docker, static)
--customize, -c	   Interactively customize the workflow
--output, -o FILE	 Output file (default: .github/workflows/TYPE-ci.yml)
--interactive, -i	 Interactive mode to select type
--list, -l			List available workflow types

analyze

Analyze existing workflows for issues and optimizations.

ghgen analyze

Checks for: - Missing dependency caching - Unpinned action versions - Overly broad triggers - Missing concurrency controls - Outdated runner versions

OPTIONS

--help, -h

Show this help message.

--version, -v

Show version information.

EXAMPLES

Auto-detect and generate workflow:

cd my-project
ghgen generate --auto

Generate a Perl workflow with customization:

ghgen generate --type=perl --customize

Interactively select and generate a workflow:

ghgen generate --interactive

Analyze all workflows in current repository:

ghgen analyze

AUTHOR

Your Name <your.email@example.com>

LICENSE

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.