Skip to main content
GitHub Achievement CLI automates earning profile achievements through automated workflows. The tool supports 5 different achievements with varying difficulty tiers.

Supported Achievements

Pair Extraordinaire

Coauthored commits on merged PRs

Pull Shark

Merged pull requests

Galaxy Brain

Accepted answers in Discussions

Quickdraw

Close issue within 5 minutes of opening

YOLO

Merge PR without code review

Achievement Tiers

AchievementDefaultBronzeSilverGoldHelper Required
Pair Extraordinaire1102448No
Pull Shark2161281024No
Galaxy Brain281632Yes
Quickdraw1---No
YOLO1---Yes
Tier numbers represent the count required to unlock that tier. For example, Pull Shark Gold requires 1024 merged pull requests.

Helper Account Requirements

Galaxy Brain and YOLO achievements require a second GitHub account (helper account) to function properly.
These achievements need a helper account because:
  • Galaxy Brain: Helper account creates discussions that you answer and mark as accepted
  • YOLO: Helper account is listed as a requested reviewer, then you merge without waiting for their review
Configure your helper account token in .env:
HELPER_TOKEN=ghp_your_helper_account_token_here

How Achievements Work

Each achievement uses a specific automation workflow:
  1. Creates operations - Branches, commits, PRs, issues, or discussions
  2. Executes actions - Merges, closes, answers, or reviews
  3. Triggers GitHub’s detection - GitHub’s backend recognizes the achievement pattern
  4. Cleans up - Removes temporary branches and resources
The tool respects GitHub rate limits with 2 concurrent operations and 15 operations per minute.

Progress Tracking

Progress is tracked locally per GitHub account in:
~/.github-achievements/<username>/
You can view your current progress using the CLI:
npm start
# Select "View Status"

Repository Cleanup

Running achievements creates many commits and PRs in your target repository.
After completing achievements, you can clean up:
  1. Reset Repo History - Use the CLI menu option to squash all commits into one
  2. Delete PR History - Delete and recreate the repository to remove PRs from your profile

Next Steps

Configuration

Set up tokens and repository settings

Usage Guide

Learn how to run achievements

Build docs developers (and LLMs) love