This repository provides a collection of reusable Git templates to streamline your workflow across multiple repositories. It includes fully supported Issue Templates, Pull Request Templates, and more.
We welcome contributions from everyone! Don’t worry if you’re not familiar with Rust—the project is primarily composed of YAML files (for workflows), Markdown files (for templates and documentation), and license files. Rust is only used for the CLI interface.
You can help by:
- Opening issues
- Suggesting new GitHub templates
- Sharing feedback to improve the project
Your ideas and participation are valued, and we’re happy to support you as you get involved.
- Issue Templates: Standardized templates for bug reports, feature requests, documentation, community collaboration, developer experience feedback, support questions, and tests.
- Pull Request Templates: Easily add consistent PR templates to your repositories.
- Easy Installation: Quickly set up templates using a provided installation script.
- Customizable: All templates can be tailored to fit your project's needs.
You can download the latest alpha release binaries for your platform from the /releases/<tag> directory. These are currently available as artifacts for different operating systems and architectures:
| Platform | Filename |
|---|---|
| macOS (Apple Silicon) | gh-templates-aarch64-apple-darwin |
| Linux (aarch64) | gh-templates-aarch64-unknown-linux-gnu |
| macOS (Intel) | gh-templates-x86_64-apple-darwin |
| Windows (x86_64) | gh-templates-x86_64-pc-windows-gnu.exe |
| Linux (x86_64, GNU) | gh-templates-x86_64-unknown-linux-gnu |
| Linux (x86_64, musl) | gh-templates-x86_64-unknown-linux-musl |
To download, visit the releases page and select the appropriate binary for your OS and architecture. Verify the SHA256 checksum after downloading.
Install gh-templates automatically with a single command:
curl -sSL https://raw.github.com/RafaelJohn9/gh-templates/main/install/install.sh | bashiwr -useb https://raw.github.com/RafaelJohn9/gh-templates/main/install/install.ps1 | iex✅ The installer automatically:
- Detects your OS and architecture
- Downloads the latest version
- Installs to the appropriate location (
~/.local/binon Linux/macOS,~/binon Windows)- Makes the binary executable
⚠️ Note: Make sure your install directory is in yourPATH. On Linux/macOS, you may need to addexport PATH="$HOME/.local/bin:$PATH"to your shell profile.
If you prefer to install manually, download the appropriate binary for your platform:
wget https://github.com/RafaelJohn9/gh-templates/releases/latest/download/gh-templates-x86_64-unknown-linux-gnu
chmod +x gh-templates-x86_64-unknown-linux-gnu
mkdir -p ~/.local/bin
mv gh-templates-x86_64-unknown-linux-gnu ~/.local/bin/gh-templateswget https://github.com/RafaelJohn9/gh-templates/releases/latest/download/gh-templates-x86_64-unknown-linux-musl
chmod +x gh-templates-x86_64-unknown-linux-musl
mkdir -p ~/.local/bin
mv gh-templates-x86_64-unknown-linux-musl ~/.local/bin/gh-templateswget https://github.com/RafaelJohn9/gh-templates/releases/latest/download/gh-templates-aarch64-unknown-linux-gnu
chmod +x gh-templates-aarch64-unknown-linux-gnu
mkdir -p ~/.local/bin
mv gh-templates-aarch64-unknown-linux-gnu ~/.local/bin/gh-templatescurl -LO https://github.com/RafaelJohn9/gh-templates/releases/latest/download/gh-templates-aarch64-apple-darwin
chmod +x gh-templates-aarch64-apple-darwin
mkdir -p ~/.local/bin
mv gh-templates-aarch64-apple-darwin ~/.local/bin/gh-templatescurl -LO https://github.com/RafaelJohn9/gh-templates/releases/latest/download/gh-templates-x86_64-apple-darwin
chmod +x gh-templates-x86_64-apple-darwin
mkdir -p ~/.local/bin
mv gh-templates-x86_64-apple-darwin ~/.local/bin/gh-templatesNew-Item -ItemType Directory -Force -Path "$env:USERPROFILE\bin"
Invoke-WebRequest -Uri "https://github.com/RafaelJohn9/gh-templates/releases/latest/download/gh-templates-x86_64-pc-windows-gnu.exe" -OutFile "$env:USERPROFILE\bin\gh-templates.exe"
⚠️ Note: Make sure$env:USERPROFILE\binis in yourPATHenvironment variable.
Below are some example commands for using gh-templates to add templates to your repository:
💡 Tip:
It is recommended you use the labels from this repository by running:
gh label clone rafaeljohn9/gh-templates
# Add an issue template
gh-templates issue add bug
# Add multiple issues
gh-templates issue add bug feature dx
# Preview an issue template
gh-templates issue preview bug
# List available issue templates
gh-templates issue list# Add a PR template
gh-templates pr add default
# Preview a PR template
gh-templates pr preview default
# List available PR templates
gh-templates pr list
# Add template and specify output location
gh-templates pr add bug --output .github/pull_request_template.md# Add a LICENSE file (MIT)
gh-templates license add mit
# Add a LICENSE file (Apache 2.0)
gh-templates license add apache-2.0
# Preview a license file
gh-templates license preview mit
# List available license files
gh-templates license list
# List popular licenses
gh-templates license list --popular
# List non-software licenses
gh-templates license list --non-software
# Force overwrite existing file
gh-templates license add mit --force# Add a .gitignore for Rust
gh-templates gitignore add Rust
# Add a .gitignore for Node.js
gh-templates gitignore add Node
# Preview a .gitignore file
gh-templates gitignore preview Rust
# List available .gitignore templates
gh-templates gitignore list# Add a code of conduct file (not yet available)
gh-templates conduct add default📌 Note: Currently,
issue,pr,license, andgitignoretemplates are supported. Support for code of conduct and other templates will be added in future releases.