GitHub Search - Morph Documentation

Search public GitHub repositories without cloning them locally. WarpGrep clones and searches the repo on Morph’s servers — no local clone or ripgrep needed.

Why?

Use GitHub search when your primary agent needs to find code snippets from a public repository that isn’t cloned locally — exploring how an open-source library works, finding usage patterns, or pulling reference implementations. See the GitHub search example.

Direct Usage

import { MorphClient } from '@morphllm/morphsdk';

const morph = new MorphClient({ apiKey: process.env.MORPH_API_KEY });

const result = await morph.warpGrep.searchGitHub({
  searchTerm: 'Find authentication middleware',
  github: 'vercel/next.js',       // or full URL: 'https://github.com/vercel/next.js'
  branch: 'canary',               // optional, defaults to repo's default branch
});

if (result.success) {
  for (const ctx of result.contexts) {
    console.log(`${ctx.file}: ${ctx.content}`);
  }
}

As an Agent Tool

Each SDK adapter provides createGitHubSearchTool():

const githubTool = morph.anthropic.createGitHubSearchTool();
// Or: morph.openai.createGitHubSearchTool()
// Or: morph.vercel.createGitHubSearchTool()

Pass githubTool in your tools array the same way as createWarpGrepTool. GitHub search returns the same WarpGrepResult format as codebase search.

Options

createGitHubSearchTool() accepts:

Option	Default	Description
`morphApiKey`	`MORPH_API_KEY` env var	API key for Morph
`morphApiUrl`	`https://api.morphllm.com`	Override API base URL
`codeSearchUrl`	`https://morphllm.com`	Code storage service URL
`timeout`	`30000`	Timeout in ms