everruns-integrations-github

GitHub-backed agent blueprints for Everruns.

everruns-integrations-github registers the github_scout capability through the Everruns integration plugin system. The capability is blueprint-only: it does not expose GitHub tools to the host agent. Instead, it contributes the github_scout blueprint — a read-only repository-exploration scout whose private tools run only inside blueprint-backed child sessions.

Part of the Everruns ecosystem — the durable agentic harness engine for building unstoppable agents. It registers with everruns-core through the Everruns integration plugin system.

Quick Example

use everruns_core::capabilities::Capability;
use everruns_integrations_github::GitHubScoutCapability;

let capability = GitHubScoutCapability;

assert_eq!(capability.id(), "github_scout");

The `github_scout` Blueprint

A read-only scout agent for repository exploration:

Searches code across GitHub repositories.
Reads UTF-8 files by repository, path, and optional ref.
Searches issues and pull requests with GitHub search qualifiers.
Resolves credentials from the existing github user connection.
Returns connection_required when no GitHub connection is available.
Depends on the built-in subagents capability, so hosts that enable github_scout also get spawn_subagent. Monitoring and steering use the generic session_tasks tools (list_tasks, get_task, message_task, cancel_task).

Tool Privacy

The host agent sees only the blueprint, through Everruns' subagent spawning flow. The GitHub REST tools are instantiated inside the child session and are never added to the host tool list.

Documentation

License

Licensed under the MIT License.