# morph-search

> Fast codebase search via WarpGrep (20x faster than grep)

- Author: Marlon Costa
- Repository: marlon-costa-dc/Continuous-Claude-v2
- Version: 20260101180544
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/marlon-costa-dc/Continuous-Claude-v2
- Web: https://mule.run/skillshub/@@marlon-costa-dc/Continuous-Claude-v2~morph-search:20260101180544

---

---
name: morph-search
description: Fast codebase search via WarpGrep (20x faster than grep)
allowed-tools: [Bash, Read]
---

# Morph Codebase Search

Fast, AI-powered codebase search using WarpGrep. 20x faster than traditional grep.

## When to Use

- Search codebase for patterns, function names, variables
- Find code across large codebases quickly
- Edit files programmatically

## Usage

### Search for code patterns
```bash
uv run python -m runtime.harness scripts/morph_search.py \
    --search "authentication" --path "."
```

### Search with regex
```bash
uv run python -m runtime.harness scripts/morph_search.py \
    --search "def.*login" --path "./src"
```

### Edit a file
```bash
uv run python -m runtime.harness scripts/morph_search.py \
    --edit "/path/to/file.py" --content "new content"
```

## Parameters

| Parameter | Description |
|-----------|-------------|
| `--search` | Search query/pattern |
| `--path` | Directory to search (default: `.`) |
| `--edit` | File path to edit |
| `--content` | New content for file (use with `--edit`) |

## Examples

```bash
# Find all async functions
uv run python -m runtime.harness scripts/morph_search.py \
    --search "async def" --path "./src"

# Search for imports
uv run python -m runtime.harness scripts/morph_search.py \
    --search "from fastapi import" --path "."
```

## vs ast-grep

| Tool | Best For |
|------|----------|
| **morph/warpgrep** | Fast text/regex search (20x faster) |
| **ast-grep** | Structural code search (understands syntax) |

## MCP Server Required

Requires `morph` server in mcp_config.json with `MORPH_API_KEY`.

## Local Fallback (No API Key)

If `MORPH_API_KEY` is not available, use **Grep tool** (ripgrep) instead:

```
# Claude Code has built-in Grep - powered by ripgrep, no API key needed
Grep(pattern="authentication", path="./src")

# With glob filtering
Grep(pattern="def.*login", glob="*.py")
```

This provides:
- ripgrep-powered search (very fast)
- Regex support
- Glob and type filtering
- No cost, no API key required

Morph is ~20x faster on very large codebases; Grep is sufficient for most projects.