v0.12.0See what's new

Turn your GitHub commits into Habitica gold and XP

Octogriffin is a free, open-source Habitica GitHub integration. Level up your character, find items and slay monsters just by writing code.

You opened a pull requestpull_request.opened
Habit scored: Opened a pull request
+ XP+ GoldEasy ★STR

Set up once, then just code

Three steps, about five minutes. After that, Octogriffin listens to GitHub and you never have to open it again.

  1. Step 1

    Install the GitHub App

    Pick the repositories you want to earn rewards from. The app only receives webhooks; it can't change your code.

  2. Step 2

    Link your Habitica account

    Sign in and paste your Habitica API token. It's encrypted before it reaches the database.

  3. Step 3

    Push, merge, review

    Any of over 100 GitHub events can score a habit. Start from a recipe or build your own trigger.

You write the rules

Every trigger reads like a sentence. Choose the event, the repositories, how hard it counts and whether it rewards or punishes you.

  • Over 100 events: commits, pull requests, reviews, releases, issues, discussions
  • Trivial to Hard: difficulty sets how much XP and Gold you get
  • Reward or punish: earn XP and Gold, or lose health for habits you want to break
  • Per repository: separate habits for work and side projects
A trigger

When pull_request_review.submitted happens in all 3 repositories, score “Reviewed a pull request” as a Medium habit and reward you. The counter resets weekly.

The same sentence sits at the top of the trigger dialog and updates as you edit.

Start from a recipe

Ready-made triggers for the habits worth keeping. One click adds one to your dashboard.

All recipes
Trivial

Code a little every day

Scores once per commit you push, so a small reward keeps big pushes from flooding your character with Gold.

When push happens, score “Pushed code” as a Trivial habit and reward you. The counter resets daily. Empty commits don't count.

Easy

Ship pull requests

Rewards finishing work and putting it up for review, not just typing.

When pull_request.opened happens, score “Opened a pull request” as an Easy habit and reward you. The counter resets weekly.

Medium

Review your teammates' code

Code reviews are easy to put off. A bigger reward makes them worth picking up.

When pull_request_review.submitted happens, score “Reviewed a pull request” as a Medium habit and reward you. The counter resets weekly.

Now in the forge

Ledger

See exactly why you got rewarded, or why you didn't.

See the full roadmap
  • Reward ledgerPlanned
  • Test a triggerPlanned
  • Token health alertsPlanned