Give any agent GitHub access
A typed tool layer for GitHub AI agents, with presets, human approval, and durable execution. Works with eve, the AI SDK, Vercel Workflow, and Chat SDK.
Pick your path
Build a standalone agent in 3 files. With the eve extension, one file registers every tool your agent needs, durable approval included.
You are a GitHub code-review assistant.AI SDK
Already have an AI SDK app? Drop the tools into generateText, streamText, or a ToolLoopAgent.
Vercel Workflow
Need agents that survive restarts and long approvals? Every tool call is a durable, retryable step.
Chat SDK
Building a GitHub, Slack, or Discord bot? Durable multi-turn sessions in ~60 lines.
Why github-tools
Agent-ready
Mount as an eve extension in one file: a complete, durable GitHub agent in 3.
Scoped by task
Presets hand an agent exactly what a job needs (code review, issue triage, security audits, releases), nothing more.
Safe by default
Every write pauses for human approval unless you opt out. Approve once per session, or gate on a predicate.
Durable by design
Every tool call is a "use step" boundary, so agents survive restarts, retries, and long-running approvals.
Token-efficient
Shaped outputs, truncated patches, paginated list tools, and toolpick integration keep token usage down.
github-tools vs the alternatives
The GitHub MCP server, the gh CLI, and raw Octokit calls all reach the GitHub API, but none of them were built as an agent's tool layer.
| github-tools | GitHub MCP server | gh CLI | Raw Octokit | |
|---|---|---|---|---|
| Integration | Native AI SDK tool() objects | MCP wire protocol via a separate process | Shell-out from the agent | Hand-written per call |
| Human approval | Built in, on by default | Host-dependent, inconsistent | None | You build it |
| Durable / retryable | Every call is a "use step" | No | No | No |
| Scoped by task | Presets (7 built-in) | Full server surface, or manual filtering | Full CLI surface | You build it |
| Token-efficient output | Shaped and truncated by design | Raw API responses | Raw text, needs parsing | Raw API responses |
| Native eve / Workflow / Chat SDK | Yes | No | No | No |