Vercel GitHub Tools

Why it's ranked here

The package addresses the awkward parts of agent access, not just API transport. Focused presets reduce exposed capabilities, writes require approval by default, and workflow support makes calls retryable. The main caveat is ecosystem commitment: AI SDK and Zod are peer dependencies, while the recommended eve route uses a separate extension.

What's good

Its safety and scope controls are unusually concrete. Read-only exploration excludes writes, security auditing permits reporting without destructive changes, and approval can vary by operation. Bundled reads gather related pull request, issue, release, or CI context in fewer steps. Individual tools remain available when presets are too broad.

Tradeoffs

The full catalogue contains 79 tools, so careless exposure can consume model context. The documentation recommends focused presets or an external selector for that reason. Durable non-streaming generation must run inside a workflow step. Notification access needs a suitable personal access token. The older direct eve integration remains available but is deprecated.

How to use it well

Use it for TypeScript agents that review pull requests, triage issues, investigate CI, prepare releases, or author focused changes. Start with the narrowest preset, set repository context, and retain approval for meaningful writes. It does not provide a model or replace the surrounding chat backend, bot, or user interface.

Observed

Primary language

TypeScript

Install surface

Published as the @github-tools/sdk package; pnpm installation is documented.

Module format

ES modules with generated TypeScript declarations.

Interface

TypeScript library exposing AI SDK tools, preconfigured agents, workflow agents, and an eve extension.

Dependencies

AI SDK and Zod are peer dependencies; AI SDK v6 or v7 is supported, while the eve subpath requires v7.

Testing structure

Vitest runs colocated source tests matching src/**/*.test.ts in a Node environment.