Examples

import { createGithubTools } from '@github-tools/sdk'
import { generateText } from 'ai'

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4.6',
  tools: createGithubTools({
    preset: 'code-review',
  }),
  prompt: 'List all open pull requests on vercel-labs/github-tools and write a one-line summary for each.',
})

console.log(text)

import { createGithubTools } from '@github-tools/sdk'
import { generateText } from 'ai'

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4.6',
  tools: createGithubTools({
    preset: 'issue-triage',
    requireApproval: {
      addIssueComment: false,
      closeIssue: true,
      createIssue: true,
    },
  }),
  prompt: `
    Read all issues labeled "needs-triage" on vercel-labs/github-tools.
    For each one, classify it as bug, feature, or question.
    Post a comment with the classification and a suggested next step.
  `,
})

import { createGithubAgent } from '@github-tools/sdk'

const reviewer = createGithubAgent({
  model: 'anthropic/claude-sonnet-4.6',
  preset: 'code-review',
  system: `
    You review pull requests for code quality and security issues.
    Always cite specific file paths and line numbers.
    Never approve a PR that introduces console.log statements.
  `,
})

Refactor this code to use createGithubAgent from @github-tools/sdk.

- Choose a preset that matches the task (code-review, issue-triage, ci-ops, repo-explorer, or maintainer)
- Preserve or improve system instructions; use patterns from https://github-tools.com/guide/examples
- If destructive GitHub writes must be human-gated, set requireApproval and follow https://github-tools.com/guide/approval-control

import { createGithubTools } from '@github-tools/sdk'
import { streamText } from 'ai'

const result = streamText({
  model: 'anthropic/claude-sonnet-4.6',
  tools: createGithubTools({
    preset: 'repo-explorer',
  }),
  prompt: 'Find all TypeScript files that export a function named "create" in vercel-labs/github-tools and explain what each one does.',
})

for await (const chunk of result.textStream) {
  process.stdout.write(chunk)
}

import { createGithubTools } from '@github-tools/sdk'
import { generateText } from 'ai'

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4.6',
  tools: createGithubTools({
    preset: 'maintainer',
    requireApproval: true,
  }),
  prompt: `
    Check if there are any stale issues (no activity for 30 days) on vercel-labs/github-tools.
    For each stale issue, post a comment asking the author for an update.
    If no response after the comment, close the issue with a polite message.
  `,
})

import { createGithubTools } from '@github-tools/sdk'
import { createToolIndex } from 'toolpick'
import { generateText } from 'ai'
import { openai } from '@ai-sdk/openai'

const tools = createGithubTools()
const index = createToolIndex(tools, {
  embeddingModel: openai.embeddingModel('text-embedding-3-small'),
})

const result = await generateText({
  model: openai('gpt-4o'),
  tools,
  prepareStep: index.prepareStep(),
  prompt: 'Check if the CI is passing on the main branch of vercel/ai.',
})

const index = createToolIndex(tools, {
  embeddingModel: openai.embeddingModel('text-embedding-3-small'),
  rerankerModel: openai('gpt-4o-mini'),
})

import { createDurableGithubAgent } from '@github-tools/sdk/workflow'
import { getWritable } from 'workflow'
import type { ModelMessage, UIMessageChunk } from 'ai'

export async function streamDurableGithubChat(
  messages: ModelMessage[],
  token: string,
  model: string
) {
  'use workflow'

  const agent = createDurableGithubAgent({
    model,
    token,
    preset: 'maintainer',
  })
  const writable = getWritable<UIMessageChunk>()
  await agent.stream({ messages, writable })
}

import { createGithubTools } from '@github-tools/sdk'
import { generateText } from 'ai'
import { createLogger } from 'evlog'
import { createAILogger } from 'evlog/ai'

async function runAgentTurn(prompt: string) {
  'use step'

  const log = createLogger()
  const ai = createAILogger(log, { toolInputs: { maxLength: 500 } })

  const result = await generateText({
    model: ai.wrap('anthropic/claude-sonnet-4.6'),
    tools: createGithubTools({ preset: 'code-review' }),
    prompt,
    maxSteps: 15,
  })

  log.emit()
  return result.text
}