Use Hermes Agent with GitHub — Automate Your Repos
Connect Hermes to GitHub for automated issue triage, PR reviews, code generation, and repo management.
Connecting Hermes to GitHub lets you automate your entire development workflow — triage issues, review PRs, monitor CI, and even write code changes, all by asking your agent in plain language.
Before you start:
- ☑Hermes Agent installed
- ☑GitHub CLI ('gh') installed and authenticated with 'gh auth login'
- ☑Optional: a GitHub personal access token for advanced API operations
Steps
- 1
Install GitHub CLI
Install gh CLI and authenticate with gh auth login
- 2
Enable GitHub skill
Add the GitHub skill to ~/.hermes/skills/ or install with hermes skills install github
- 3
Configure access
Set your GitHub token in config.yaml or use gh CLI's existing auth
- 4
Use GitHub tools
Ask Hermes to create issues, review PRs, check CI status, or search code
- 5
Set up webhooks (optional)
Configure GitHub webhooks to trigger Hermes on new issues or PRs automatically
Pro Tips
- 💡Install the GitHub skill to give Hermes structured instructions for common GitHub tasks: 'hermes skills install github'
- 💡Use Hermes for issue triage: 'go through today's new issues and label them by type' saves hours of manual work
- 💡Set up GitHub webhooks to trigger Hermes automatically on new issues or PRs — turn your agent into a 24/7 repo assistant
Troubleshooting
❌ Hermes can't find GitHub CLI
✅ Install gh CLI first: 'brew install gh' on macOS or follow github.com/cli/cli#installation. Then authenticate with 'gh auth login'.
❌ GitHub API rate limit errors
✅ Authenticated requests get 5,000 requests/hour. If hitting limits, add a personal access token with 'gh auth login --with-token'. Check current usage with 'gh api rate_limit'.
❌ Hermes creates issues/PRs with wrong formatting
✅ Define a GitHub template in your skill folder that specifies the exact format for issues and PRs. Hermes will follow the template when creating new GitHub items.