Skip to main content

​
GitHub Achievement CLI

Automate GitHub profile achievements with style. This beautiful command-line interface helps you unlock achievement badges on your GitHub profile through automated workflows.

Interactive CLI

Beautiful terminal interface built with React and Ink. Navigate menus, select achievements, and track progress in real-time.

Smart Rate Limiting

Respects GitHub’s API limits with 2 concurrent operations, 15 ops/min, and automatic retry with exponential backoff.

Progress Tracking

Local database tracks your achievement progress per account. View status and resume interrupted runs.

Clean Workflows

Creates temporary branches, commits, and PRs. Built-in repo history reset squashes everything to a single commit when done.

​
Supported Achievements

Unlock 5 GitHub achievements with tiered progression:
Coauthored commits on merged pull requests.Tiers:
  • Default: 1 coauthored commit
  • Bronze: 10 coauthored commits
  • Silver: 24 coauthored commits
  • Gold: 48 coauthored commits
How it works: Creates commits with Co-authored-by trailers, opens PRs, and merges them to trigger the achievement.
Opened pull requests that have been merged.Tiers:
  • Default: 2 merged PRs
  • Bronze: 16 merged PRs
  • Silver: 128 merged PRs
  • Gold: 1024 merged PRs
How it works: Creates branches, commits changes, opens PRs, and auto-merges them.
Answered discussions with accepted answers.Tiers:
  • Default: 2 accepted answers
  • Bronze: 8 accepted answers
  • Silver: 16 accepted answers
  • Gold: 32 accepted answers
Requirements: Requires a helper account to create discussions and mark answers as accepted. Repository must have Discussions enabled.
Closed an issue within 5 minutes of opening it.Tier: Single tier (1 quick close)How it works: Opens an issue and immediately closes it to trigger the achievement.
Merged a pull request without code review.Tier: Single tier (1 unreviewed merge)Requirements: Requires a helper account to create the PR (you merge it without review).

​
How It Works

The CLI executes achievement-specific workflows:
1

Select Achievements

Choose which achievements and tiers you want to unlock from the interactive menu.
2

Automated Execution

The tool creates temporary branches in your target repository, makes commits, opens PRs, and performs the actions needed to trigger achievements.
3

Progress Tracking

All progress is tracked locally. View status, see completion percentages, and resume if interrupted.
4

Cleanup

Use the built-in Reset Repo History feature to squash all commits to a single commit, keeping your repository clean.
The tool operates on a repository you own. All actions are automated but follow GitHub’s official achievement criteria.

​
Key Features

  • Beautiful Terminal UI: Built with React and Ink for a modern CLI experience
  • Setup Wizard: First-run wizard guides you through token creation and configuration
  • Multi-language Support: English and other languages supported
  • Rate Limit Handling: Automatic retry with backoff, respects GitHub API limits
  • Progress Persistence: SQLite database tracks progress per user account
  • Concurrent Execution: Runs 2 operations in parallel for faster completion
  • Error Recovery: Graceful error handling with detailed logging

​
Requirements

Node.js 18+

Required runtime environment

GitHub Token

Personal Access Token with repo scope

Your Repository

A repository you own for creating branches/PRs
Galaxy Brain and YOLO achievements require a second GitHub account (helper account) with its own token.

​
Next Steps

Quickstart

Get up and running in under 5 minutes

Installation

Detailed installation and setup instructions

Build docs developers (and LLMs) love

Get started for freeTalk to us