@cybernetyx1/atlasflow-github

GitHub REST tools and persona slot bindings for AtlasFlow agents — read repos, PRs, issues, and files, or post guarded review output.

Install

npm install @cybernetyx1/atlasflow-github

Part of the AtlasFlow monorepo. Proprietary.

Usage

githubTools(options) returns the raw GitHub tools for an agent. githubBinding(options) returns a persona binding that resolves a token from the environment (fine-grained PAT, GitHub App installation token, or Actions token) and fills the github manifest slot.

import { githubTools } from "@cybernetyx1/atlasflow-github";

// Direct: pass a token and default owner/repo.
const tools = githubTools({
  token: process.env.GITHUB_TOKEN,
  owner: "cybernetyx",
  repo: "atlasflow",
});

import { githubBinding } from "@cybernetyx1/atlasflow-github";

// Persona slot binding: resolves the token from env at runtime.
const binding = githubBinding({ tokenEnv: "GITHUB_TOKEN", slot: "github" });

Also exported: githubToolBinding, createGitHubClient, createGitHubAppJwt, resolveGitHubAppInstallationToken, resolveGitHubTokenFromEnv, the GitHubApiError class, and the GitHubToolsOptions / GitHubEnvBindingOptions types.

License

Proprietary. © 2026 Cybernetyx. See LICENSE.