Frequently Asked Questions
Everything you need to know about the syncing process, XP calculations, and security.
We use GitHub Webhooks to listen for activity on your connected repositories. When you push code, open a pull request, or close an issue, GitHub notifies our servers.
We then analyze the event metadata (like commit size or issue complexity) to calculate a fair XP reward. Finally, we use the Habitica API to score a custom task on your account, instantly granting you Gold and Experience.
Absolutely. We take security seriously. Our integration requests the minimum permissions required to function.
We primarily look at event metadata (timestamps, commit messages, file counts). We do not store your source code, and we do not have write access to your code content - only the ability to read metadata to verify activity.
There are a few common reasons for this:
- Connection Status: Ensure your Habitica User ID and API Token are correct in the Dashboard.
- Repo Configuration: Verify that the repository you pushed to is actually installed in the GitHub App settings.
Currently, we use a fixed reward structure for every contribution. We are working on a future "Difficulty Multiplier" update that will allow you to customize these values and set specific repositories to "Hard" mode for greater challenges and rewards.
We track activity across all branches! However, to prevent double-dipping, we usually reward the initial commit push. Merging a branch into main does not grant duplicate XP for the same commits, but the Pull Request action itself generates a separate "Task Completion" reward.
Yes! Octogriffin is a passion project built by developers, for developers. It is currently free to use. In the future, we may introduce a premium tier for advanced analytics or team features, but the core syncing will always remain free.