Skip to main content
The Galaxy Brain achievement is earned by providing accepted answers to GitHub Discussions. This achievement requires a helper account to create the discussions.

Achievement Details

PropertyValue
Achievement IDgalaxy-brain
Icon🧠
DescriptionAnswered discussions (requires helper account)
Helper AccountRequired
This achievement requires a second GitHub account (helper account) to function. The helper creates discussions that you answer.

Tiers

Default Tier

2 accepted answers

Bronze Tier

8 accepted answers

Silver Tier

16 accepted answers

Gold Tier

32 accepted answers

Prerequisites

1. Enable Discussions

Your target repository must have Discussions enabled:
  1. Go to repository Settings
  2. Scroll to Features section
  3. Enable Discussions
The tool automatically checks if discussions are enabled before running this achievement.

2. Helper Account Setup

Configure your helper account token in .env:
GITHUB_TOKEN=ghp_your_main_token_here
GITHUB_USERNAME=your-username
TARGET_REPO=your-username/your-repo

# Helper account (required for Galaxy Brain)
HELPER_TOKEN=ghp_your_helper_token_here
The helper account should have read/write access to your target repository’s discussions.

How It Works

The automation uses both your main account and the helper account:
  1. Helper creates discussion - Opens a new discussion question
  2. You post answer - Main account posts a detailed answer
  3. Helper marks answer as accepted - Marks your answer as the accepted solution
  4. Achievement triggers - GitHub recognizes the accepted answer
Each accepted answer increments your Galaxy Brain achievement count.

Implementation Details

The achievement class checks if discussions are enabled (from src/achievements/galaxyBrain.ts:26-34):
private async checkDiscussions(): Promise<void> {
  if (this.discussionsEnabled === null) {
    this.discussionsEnabled = await areDiscussionsEnabled(this.owner, this.repo);
    
    if (!this.discussionsEnabled) {
      throw new DiscussionsNotEnabledError(`${this.owner}/${this.repo}`);
    }
  }
}
The main operation (from src/achievements/galaxyBrain.ts:36-51):
protected async executeOperation(number: number): Promise<{
  discussionId?: string;
}> {
  await this.checkDiscussions();
  
  logger.debug(`Creating Galaxy Brain discussion #${number}`);
  
  // Create a discussion with an accepted answer
  const discussion = await createGalaxyBrainDiscussion(this.owner, this.repo, number);
  
  logger.verbose(`Completed Galaxy Brain #${number} (Discussion #${discussion.number})`);
  
  return {
    discussionId: discussion.id,
  };
}

Workflow Example

Here’s what happens when you run Galaxy Brain for Default tier (2 answers):
✓ Check discussions enabled in repository
✓ Helper account creates discussion "Question #1"
✓ Main account posts answer
✓ Helper account marks answer as accepted
✓ Discussion #1 completed

✓ Helper account creates discussion "Question #2"
✓ Main account posts answer
✓ Helper account marks answer as accepted
✓ Discussion #2 completed

Error Handling

If discussions are not enabled, you’ll see:
❌ Error: Discussions are not enabled for owner/repo

Please enable Discussions in your repository settings:
1. Go to Settings → Features
2. Enable Discussions
3. Try again

Estimated Time

From the achievement definition in src/achievements/index.ts:52:
  • Estimated time per unit: 4000ms (4 seconds)
  • Default tier (2): ~8 seconds
  • Bronze tier (8): ~32 seconds
  • Silver tier (16): ~64 seconds
  • Gold tier (32): ~128 seconds (~2 minutes)
Discussions operations use GitHub’s GraphQL API, which has separate rate limits from the REST API.

Cleanup Considerations

Unlike branches and PRs, discussions remain in your repository after completion.
After earning Galaxy Brain, you may want to:
  1. Archive discussions - Manually archive or lock the automated discussions
  2. Label them - Add a label like “automation” to identify them
  3. Keep them - Leave them as documentation of your achievement process

Comparison with Other Achievements

FeatureGalaxy BrainPull SharkYOLO
Helper accountRequiredNot requiredRequired
Repository featureDiscussionsPRsPRs
CleanupManualAutomaticAutomatic
Gold tier321024N/A (single tier)

Next Steps

YOLO

Another achievement that requires a helper account

Configuration

Learn how to set up your helper account

Build docs developers (and LLMs) love