morph-plugin

Claude Code plugin + CLI for Morph. Three tools:

• Fast Apply — 10,500+ tok/s code editing with lazy markers
• WarpGrep — fast agentic codebase search, +4% on SWE-Bench Pro, -15% cost
• Public Repo Context — grounded context search for public GitHub repos without cloning

Setup

1. Get an API key

Sign up at morphllm.com/dashboard and add it to your environment:

export MORPH_API_KEY="sk-..."

2. Install the CLI

npm i -g @morphllm/morph-plugin

3. Configure Claude Code

Add the tool routing instructions so Claude Code knows when to use morph:

# Copy to your project
cp node_modules/@morphllm/morph-plugin/instructions/claude-code.md .claude/instructions/

# Or add to global CLAUDE.md
cat node_modules/@morphllm/morph-plugin/instructions/claude-code.md >> ~/.claude/CLAUDE.md

Set the API key in Claude Code settings (~/.claude/settings.json):

{
  "env": {
    "MORPH_API_KEY": "sk-..."
  }
}

CLI Commands

morph edit --file <path>

10,500+ tok/s code merging. Pipe partial code snippets via stdin with // ... existing code ... markers.

echo '// ... existing code ...
function hello() {
  return "hello world";
}
// ... existing code ...' | morph edit --file src/app.ts

Safety guards block writes when markers leak into merged output or when the merge loses too much of the original file.

morph search --query <text> [--dir <path>]

Fast agentic codebase search via WarpGrep. Sub-6s per query.

morph search --query "how does auth middleware work"
morph search --query "database config" --dir ./backend

morph github --repo <owner/repo> --query <text>

Grounded context search for public GitHub repos without cloning.

morph github --repo "vercel/next.js" --query "middleware matching"
morph github --url "https://github.com/axios/axios" --query "retry logic"

Tool Selection Guide

| Task | Tool | Why | |------|------|-----| | Large file (300+ lines) | morph edit | Partial snippets, no exact matching | | Multiple scattered changes | morph edit | Batch edits efficiently | | Small exact replacement | Edit | Faster, no API call | | New file creation | Write | morph edit only edits existing files | | Codebase search / exploration | morph search | Fast agentic search | | Public GitHub repo understanding | morph github | Grounded context without cloning | | Exact keyword lookup | Grep | Direct ripgrep, no API call |

Exit Codes

| Code | Meaning | Action | |------|---------|--------| | 0 | Success | Continue | | 1 | Input or config error | Fix input, retry | | 2 | API or network error | Retry once, then fallback to native tool | | 3 | Safety guard blocked | Use native Edit tool instead |

Development

bun install
bun test          # 187 tests
bun run typecheck # tsc --noEmit
bun run build     # tsc

License

MIT