# GitHub tools

> 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.

## Documentation Sets

- [GitHub tools](https://github-tools.com/llms-full.txt): 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.

## Docs

- [Introduction](https://github-tools.com/raw/getting-started/introduction.md): Give any agent GitHub access, with presets, human approval, and durable execution. Works with eve, the AI SDK, Vercel Workflow, and Chat SDK.
- [Installation](https://github-tools.com/raw/getting-started/installation.md): Install @github-tools/sdk, add the peer dependencies for your framework (AI SDK, eve, Vercel Workflow), and configure your GitHub token.
- [Quick Start](https://github-tools.com/raw/getting-started/quick-start.md): Call GitHub from your first AI SDK request in under five minutes, then level up to agents, eve, and durable workflows.
- [Agent Skills](https://github-tools.com/raw/getting-started/agent-skills.md): Install the GitHub tools agent skill from github-tools.com for Cursor, Claude Code, and other assistants.
- [Build a GitHub agent with the eve extension](https://github-tools.com/raw/frameworks/eve-extension.md): Mount @github-tools/eve-extension under agent/extensions/ to add all 79 GitHub tools to an eve agent, the recommended way to wire GitHub into eve, with durable approval and Vercel Connect support.
- [Use GitHub tools with the AI SDK](https://github-tools.com/raw/frameworks/ai-sdk.md): Call GitHub from generateText, streamText, or a ToolLoopAgent, the core integration path for @github-tools/sdk in any Vercel AI SDK app.
- [Durable agents with Vercel Workflow](https://github-tools.com/raw/frameworks/vercel-workflow.md): Run GitHub tools as durable, retryable steps with createDurableGithubAgent, crash-safe agents for Nuxt and Next.js apps on Vercel.
- [Build GitHub bots with Chat SDK](https://github-tools.com/raw/frameworks/chat-sdk.md): Connect GitHub tools to Chat SDK for durable GitHub, Slack, and Discord bots, a complete PR review agent in about 60 lines of code.
- [Examples](https://github-tools.com/raw/examples/overview.md): Complete, copy-pasteable GitHub agents for every framework, eve, the AI SDK, Vercel Workflow, and Chat SDK, plus a manager agent that delegates to scoped sub-agents.
- [Example: a stale issue triager with eve](https://github-tools.com/raw/examples/eve-stale-issue-triager.md): Build an eve agent that finds inactive GitHub issues, asks the author for an update, and closes them if nothing comes back, all files included.
- [Example: a release notes generator with the AI SDK](https://github-tools.com/raw/examples/ai-sdk-release-notes-generator.md): A standalone AI SDK script that drafts release notes from merged pull requests since the last tag, using the release-manager preset and Vercel Connect.
- [Example: a CI failure bot with Vercel Workflow](https://github-tools.com/raw/examples/vercel-workflow-ci-failure-bot.md): A durable chat backend that diagnoses failing GitHub Actions runs, built with createDurableGithubAgent, the ci-ops preset, and Vercel Connect.
- [Example: an issue triage bot with Chat SDK](https://github-tools.com/raw/examples/chat-sdk-issue-triage-bot.md): A durable GitHub bot that triages @mentioned issues, classifies them, and labels them, built with Chat SDK, Vercel Workflow, the issue-triage preset, and Vercel Connect.
- [Example: a manager agent with scoped sub-agents](https://github-tools.com/raw/examples/manager-agent-with-subagents.md): A broadly-capable GitHub manager agent that delegates to specialist eve sub-agents, each scoped to one preset (code-review, issue-triage, release-manager), instead of one agent holding every tool.
- [Recipes](https://github-tools.com/raw/examples/recipes.md): Short, focused GitHub agent snippets, selective approval, a reusable review agent, read-only exploration, toolpick, and evlog observability.
- [Scope with Presets](https://github-tools.com/raw/guide/presets.md): Expose only the tools your workflow needs using presets.
- [Control Write Safety](https://github-tools.com/raw/guide/approval-control.md): Gate dangerous operations with human approval policies.
- [Commit Attribution](https://github-tools.com/raw/guide/commit-attribution.md): Configure author, committer, and co-authorship for commits created by GitHub tools.
- [Tokens and Authentication](https://github-tools.com/raw/guide/tokens-and-auth.md): Authenticate GitHub tools with fine-grained PATs or Vercel Connect, map token permissions to each preset and apply least privilege.
- [Vercel Connect](https://github-tools.com/raw/guide/vercel-connect.md): Use @github-tools/sdk/connect to mint scoped GitHub tokens from a Vercel Connect connector, preset-derived scopes, zero boilerplate.
- [Working Context and Composites](https://github-tools.com/raw/guide/working-context.md): Default owner/repo/PR/issue/ref on tools, prefer composite reads, and keep payloads lean with detail, includePatch, and line ranges.
- [Tools Catalog](https://github-tools.com/raw/api/tools-catalog.md): Every available tool, grouped by domain and write-safety status. Tools run as durable workflow steps when used with Vercel Workflow.
- [API Reference](https://github-tools.com/raw/api/reference.md): Type signatures for createGithubTools, createGithubAgent, createDurableGithubAgent, and createOctokit.
- [Build a GitHub agent with eve (direct import)](https://github-tools.com/raw/deprecated/eve.md): Deprecated. The direct @github-tools/sdk/eve import registers all 79 tools via defineDynamic with durable human-in-the-loop approval. Prefer the eve extension for new agents.