GitHub App

Monitor agent repositories — workflow runs, pull requests, run health, and self-healing fixes for agents deployed from GitHub.

What the GitHub App does

The Solen GitHub App connects your agent repositories to the Runtime Kernel heal pipeline. Once installed and linked to an agentId, it:

• Correlates commits and deployments with live agent runs in /agents
• Watches workflow runs and deployments for agent startup failures
• Analyzes new pull requests for changes that could break agent runs (tool schema changes, prompt regressions, dependency risk)
• Opens heal PRs (supervised) or applies fixes (autonomous) when an agent run fails in production

Solen subscribers get GitHub App monitoring included in their plan. See also the GitHub App landing page for pricing.

Installation

Install takes under two minutes:

1. Open the Solen GitHub App install page and click Install.
2. Choose your organization or personal account and select which agent repositories to grant access.
3. After redirect, sign in to Solen (if prompted) so the installation links to your workspace.
4. In Solen, go to Settings → Integrations → GitHub App to configure each connected repo.

GitHub Marketplace          Solen dashboard
      │                            │
      ├─ Install App ─────────────►│  OAuth callback
      │  (select agent repos)    │  links installation
      │                            │
      │                            ├─ Settings → GitHub App
      │                            │  set agentId + autonomy
      └────────────────────────────┴─ Agent monitoring starts

What happens on each PR

When a pull request is opened on a connected agent repository, Solen runs automated analysis:

1. Fetches changed files from the PR diff
2. Scans for agent risk: tool schema changes, prompt edits, dependency updates, and unsafe patterns
3. Compares changed paths against historically failure-prone files from past agent heals
4. Attaches DORA metrics for the linked agentId
5. Posts a summary comment on the PR with risk level and a link to the agent dashboard at /agents

If critical agent-risk findings are detected, Solen submits a Request changes review instead of a comment.

Pushes to the default branch on linked repos also trigger agent security scans in the Solen dashboard.

How to link repos to agents

Linking a GitHub repo to an agentId enables PR analysis with heal history, DORA metrics, and unified incident tracking for that agent.

1. Install the GitHub App and confirm the repo appears under Settings → Integrations → GitHub App.
2. Set the linked agentId (must match the ID used in withSolen()) and choose an autonomy mode (supervised or autonomous).
3. Open the agent in the /agents dashboard and go to agent settings (or the GitHub integration panel).
4. Select the connected repository from the dropdown and save. The repo is now linked to the agent.

After linking, PR comments include a direct link to the agent run history, and heal events appear in the agent timeline.

SDK instrumentation

For live run monitoring and checkpoint heals, instrument your agent with @solenai/sdk. The GitHub App complements SDK telemetry with repo-level analysis and heal PRs — it does not replace in-process step reporting.

See Getting started for the withSolen() setup.

← All integrations