chp-adapter-github

GitHub inspection as governed Capability Host Protocol capabilities. Read-only first slice: repositories, pull requests, issues, CI workflow runs, and PR reviews — each exposed as chp.adapters.github.<op> with a full execution evidence chain.

Built on the canonical chp-core adapter template (BaseAdapter + @capability), the same pattern as chp-adapter-mcp.

Install

pip install chp-adapter-github

Usage

from chp_core import LocalCapabilityHost, register_adapter
from chp_adapter_github import GitHubAdapter, GitHubConfig

host = LocalCapabilityHost()
register_adapter(host, GitHubAdapter(GitHubConfig()))  # token from GITHUB_TOKEN

pr = host.invoke("chp.adapters.github.get_pull_request", {
    "owner": "capabilityhostprotocol", "repo": "chp-core", "number": 1,
})
print(pr.data["state"], pr.data["mergeable_state"])

Capabilities (read-only)

Capability	Purpose
`chp.adapters.github.get_repo`	Repository metadata
`chp.adapters.github.list_pull_requests`	List PRs (state filter)
`chp.adapters.github.get_pull_request`	Single PR + merge/CI detail
`chp.adapters.github.list_issues`	List issues (PRs excluded)
`chp.adapters.github.get_issue`	Single issue
`chp.adapters.github.list_workflow_runs`	GitHub Actions CI status
`chp.adapters.github.list_pr_reviews`	Reviews on a PR

Each returns a curated projection — a capability, not a raw API mirror.

Auth

GitHubConfig.token (or the GITHUB_TOKEN / GH_TOKEN env var). A token is optional for public reads but raises the rate limit. The token is sent in the Authorization header and never appears in evidence payloads.

Design notes

A fresh httpx.AsyncClient is created per call: the host runs handlers via asyncio.run (a new loop per host.invoke), and an AsyncClient is loop-bound.
GitHubConfig.transport accepts an httpx transport (e.g. httpx.MockTransport) for tests — no network required.
Write operations (create issue, comment, etc.) are a deliberate later slice; they carry a higher risk tier and policy gates.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

chp_adapter_github-0.23.0-py3-none-any.whl (7.8 kB view details)

Uploaded Jul 12, 2026 Python 3

File details

Details for the file chp_adapter_github-0.23.0-py3-none-any.whl.

File metadata

Download URL: chp_adapter_github-0.23.0-py3-none-any.whl
Upload date: Jul 12, 2026
Size: 7.8 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.12.7

File hashes

Hashes for chp_adapter_github-0.23.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`437a8d6a1ad37bf88c009f60fe83b18421639e7a6d0b4bfedee0e7e3b262a458`
MD5	`787cc7c907690db0aa2e4911cff0fbc0`
BLAKE2b-256	`2bd6c7a7c21da5e9e5763c7cfd20470f510bcc84c675d56135f90e042ae25517`