GitHub Tools Documentation

AI-callable GitHub tools for generateText, streamText, and agent loops.

Three layers, one SDK

Tools

42 AI-callable GitHub operations — repositories, branches, pull requests, issues, commits, search, gists, and workflows.

Presets

Curated tool subsets for focused workflows. Create specialized agents with separation of concerns.

Agents

Pre-configured agents with tools, presets, and system instructions ready to use.

Quick Start

Use GitHub tools in your first AI SDK call.

Control Write Safety

Gate dangerous operations with approval policies.

Configure Token Scopes

Map GitHub token permissions to each preset.

Examples

Complete scripts you can copy and adapt.