Skip to main content
Prompt for your coding agent
Read https://docs.morphllm.com/sdk/components/warp-grep and integrate WarpGrep into our agent. Search for where our agent's tools or subagents are defined and register WarpGrep there as a code-search subagent, keeping raw grep for exact-string lookups. Before designing anything, deep-dive how WarpGrep's multi-turn tool-calling loop works at https://docs.morphllm.com/sdk/components/warp-grep/direct: it runs grep and read operations in its own context window and returns only the relevant spans. Write out an integration plan first, then implement and verify with a real natural-language search.
Coding agents spend 60% of their turns searching for code. Each search dumps file contents into the main context window, crowding out the reasoning the agent actually needs. WarpGrep fixes this by searching in a separate context window. It’s a code search subagent: a dedicated LLM call that takes a natural language query, runs multiple grep and file-read operations, reasons about what’s relevant, and returns matching code. Typical searches complete in under 6 seconds.

​
Capabilities

CapabilityWhat it does
Codebase SearchSearch local repositories on disk
GitHub SearchSearch public GitHub repos without cloning
StreamingStream search steps back in real-time

​
When to Use WarpGrep

Use WarpGrep when:
  • Exploring unfamiliar code (“find the auth middleware”, “how does billing work”)
  • Finding implementations scattered across multiple files
  • Locating code by description rather than exact pattern
  • Search results would pollute your main agent’s context window
Use raw grep when:
  • You already know the exact string or regex you’re looking for
  • You need a simple one-off pattern match
  • Latency under 100ms matters (WarpGrep’s LLM reasoning adds seconds)
  • You don’t need cross-file reasoning, just matching lines
WarpGrep’s SDK is TypeScript/Node.js only. Python developers can use the raw API protocol or the Python guide.

​
Prerequisites

Install the SDK: 
npm install @morphllm/morphsdk
For Codebase Search, you also need ripgrep. Install via your package manager (brew install ripgrep, apt-get install ripgrep, or choco install ripgrep). GitHub Search runs fully on the cloud, no local dependencies needed. Get your API key from the Morph Dashboard.
WarpGrep works in sandboxed environments. Use remoteCommands to search code in Vercel Sandbox, Cloudflare, E2B, and more.

​
Quick Start

Save the following as search.ts: 
import { MorphClient } from '@morphllm/morphsdk';

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

  const result = await morph.warpGrep.execute({
    searchTerm: 'Find authentication middleware',
    repoRoot: '.'
  });

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

main();
Install dependencies and run: 
npm install @morphllm/morphsdk
npx tsx search.ts
Expected output: 
File: src/auth/middleware.ts
export function authMiddleware(req, res, next) {
  const token = req.headers.authorization;
  ...
}
repoRoot is relative to where you run your script. Use an absolute path (e.g., path.resolve('./myproject')) to avoid searching the wrong directory.

​
Pricing

TypePrice
Input$0.80 per 1M tokens
Output$0.80 per 1M tokens

​
Next Steps

Add WarpGrep to Your Agent

Add WarpGrep as a tool to your Anthropic, OpenAI, or Vercel AI SDK agent.

Raw Protocol

Build a custom harness in any language

Examples

10 self-contained examples in TypeScript and Python