GitHub
Connect Mogplex to GitHub identity, App coverage, repo import, comments, PRs, issues, reviews, triggers, and automations.
GitHub is the first integration most Mogplex accounts need.
It does two separate jobs:
- identity and repo discovery through GitHub OAuth
- webhook-backed routing through the Mogplex GitHub App
Keep those separate while debugging. A repo can be visible in Projects and still fail to trigger hosted work if the owner does not have GitHub App coverage.
Setup order
- Open Settings and connect GitHub.
- Install the Mogplex GitHub App for the user or org that owns the repos.
- Confirm installation coverage in Installations.
- Sync or import repos in Projects.
- Choose the routing surface that matches the work: Triggers, Assignments, or Automations.
- Verify the first run in Observability.
OAuth vs GitHub App coverage
| State | What it unlocks | What it does not unlock yet |
|---|---|---|
| GitHub disconnected | Nothing GitHub-backed | Repo import, repo creation, webhook routing |
| OAuth connected | Account identity and repo import | Webhook-backed routing |
| App installed | Repo coverage for GitHub events | Synced repos until import or sync completes |
| App installed and repos synced | Full GitHub-backed setup | N/A |
Use GitHub App Coverage when a repo is visible but Triggers or Automations cannot route work into it.
What GitHub can start
Mogplex GitHub routing can start work from issue comments, PR comments, PR review comments, commit comments, repo events, and the specific routing events exposed by the current trigger or automation surface.
The important choice is scope:
- use Triggers for one GitHub event waking one agent
- use Assignments for durable repo-owned work
- use Automations for graph-shaped work with branching, delays, publishing, or parallel agents
Mention routing
Mogplex recognizes two mention forms in GitHub comments:
@mogplex@mogplex/<agent-slug>
Bare @mogplex routes only to the default mention target. Targeted mentions
route by agent slug.
Use GitHub Mention Routing for the exact rules, including entry-agent behavior in automations.
Where to check state
- Settings: GitHub connection state and account-level setup
- Installations: App coverage, repo eligibility, and synced repo state
- Projects: imported repo list, repo settings, and workspace entry points
- Observability: run status and failure trail after a GitHub event starts work
Common failures
- Repo is visible but triggers are empty: OAuth is connected, but App coverage is missing for the repo owner.
- Mention does not wake the expected agent: the comment may be bare
@mogplexwhen it needed@mogplex/<agent-slug>, or the wrong route is marked default. - Automation cannot find the expected repo: check installation coverage and repo sync before editing the automation.
- PR review work starts in the wrong shape: use an Assignment for standing repo responsibility, not a one-off Trigger.