Guide
Getting Started
Install and set up gh-please extension
Getting Started
Prerequisites
Before installing gh-please, make sure you have:
- GitHub CLI (
gh) - Version 2.0 or higher - Bun - JavaScript runtime and toolkit (required for some features)
Installation
Install from GitHub
gh extension install pleaseai/gh-please
Install in CI / Docker (no authentication)
gh extension install works fine on a personal machine, but in CI or during a
Docker build it talks to the GitHub API, whose unauthenticated rate limit
(60 requests/hour per IP) is shared across runners and is easily exhausted —
gh then reports the resulting HTTP 403 as an authentication error.
Use the standalone installer instead. It downloads the precompiled binary from the public release CDN, so it needs no token and bakes no secret into your image:
curl -fsSL https://raw.githubusercontent.com/pleaseai/gh-please/main/scripts/install.sh | bash
# Pin a specific version (reproducible builds) — pin the script and the binary to the same tag:
TAG=github-v0.32.0
curl -fsSL "https://raw.githubusercontent.com/pleaseai/gh-please/${TAG}/scripts/install.sh" | bash -s -- --version "${TAG}"
Prefer
gh extension install in CI? Provide a token to lift the rate limit — in
GitHub Actions set env: { GH_TOKEN: ${{ github.token }} }.Install for Development
git clone https://github.com/pleaseai/gh-please.git
cd gh-please
bun install
gh extension install .
Verify Installation
gh please --version
Quick Start
Once installed, you can immediately use core commands without any additional setup:
# Issue management
gh please issue sub-issue list 123
# PR management
gh please pr review reply <comment-id> -b "Fixed in latest commit!"
Next Steps
- Quick Start Guide - Learn the most common commands
- Issue Management - Manage sub-issues and dependencies
- PR Management - Handle code reviews efficiently