REPO · Adapter
repo-github
via GitHub
Repository registrar — create, delete, get, derive remote URL.
@openagentry/adapter-repo-github npm → — · Install
Use it
# Install
$ npm install @openagentry/adapter-repo-github
# Or in a workspace registered with the CLI
$ npx agentry init @openagentry/adapter-repo-github — · Default export
Pattern: lazy
The default export is always a frozen REPOAdapter
with static category + id. Methods read env on
first call and cache the underlying instance. Missing config produces an
AgentryError at the use-site, not at import.
import default_ from '@openagentry/adapter-repo-github';
// → repoAdapter — category: 'repo', id: 'repo-github' — · Environment
Configuration
| Variable | Notes |
|---|---|
| OA_GITHUB_TOKEN | Required. |
| OA_GITHUB_ENDPOINT | Optional. |
— · Reported capabilities
What the manifest says
agentry capabilities --json reports these flags from
the package's openagentry.capabilities manifest block.
- transport
- https
- enterpriseServer
- true
— · Failure modes
Error codes
8 stable codes this adapter throws. Each has a one-line resolution.
-
E_GITHUB_AUTHGitHub token missing or rejected. -
E_GITHUB_NOT_FOUNDRepository not found. -
E_GITHUB_PERMISSIONToken lacks permission for the operation. -
E_GITHUB_INVALIDGitHub rejected the input shape. -
E_GITHUB_RATE_LIMITGitHub rate limit reached. -
E_GITHUB_NETWORKNetwork failure reaching GitHub. -
E_GITHUB_UPSTREAMGitHub returned a non-2xx response. -
E_GITHUB_SCHEMAInput failed Zod validation.