Synopsis
Description
github manages profClaw’s GitHub integration. Once connected, profClaw can listen for GitHub webhooks (issues, pull requests, comments, pushes) and automatically dispatch agent tasks in response. It can also read repository context for agents working on code.
Subcommands
| Subcommand | Description |
|---|---|
status | Show GitHub connection status and configured repositories |
connect | Add a GitHub token and configure webhook |
disconnect | Remove the GitHub integration |
repos | List connected repositories |
sync <repo> | Manually sync open issues from a repository |
webhook | Show webhook configuration for a repository |
github connect
GitHub personal access token or GitHub App token. Requires
repo and read:org scopes for private repos.Repository to connect in
owner/repo format.github sync <repo>
Repository in
owner/repo format.Only sync issues with this label (e.g.,
profclaw, ai-task).Maximum issues to sync.
Examples
Webhook Events
When a webhook is configured, profClaw responds to:| Event | Action |
|---|---|
issues.opened | Create an agent task for the new issue |
issues.labeled | Trigger when a specific label is applied |
pull_request.opened | Trigger code review workflow |
issue_comment.created | Respond to @profclaw mentions |
push | Trigger on-push workflows |
Environment Variables
Related
profclaw jira- Jira integrationprofclaw linear- Linear integrationprofclaw sync- Cross-platform sync operations- GitHub Integration Guide - Full setup instructions