Best use case
morph-search is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Fast codebase search via WarpGrep (20x faster than grep)
Teams using morph-search should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/morph-search/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How morph-search Compares
| Feature / Agent | morph-search | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Fast codebase search via WarpGrep (20x faster than grep)
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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/mcp/morph_search.py \
--search "authentication" --path "."
```
### Search with regex
```bash
uv run python -m runtime.harness scripts/mcp/morph_search.py \
--search "def.*login" --path "./src"
```
### Edit a file
```bash
uv run python -m runtime.harness scripts/mcp/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/mcp/morph_search.py \
--search "async def" --path "./src"
# Search for imports
uv run python -m runtime.harness scripts/mcp/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`.Related Skills
search-tools
Search Tool Hierarchy
search-router
Choose the right search tool for each query type
research
Document codebase as-is with thoughts directory for historical context
research-external
External research workflow for docs, web, APIs - NOT codebase exploration
research-agent
Research agent for external documentation, best practices, and library APIs via MCP tools
repo-research-analyst
Analyze repository structure, patterns, conventions, and documentation for understanding a new codebase
perplexity-search
AI-powered web search, research, and reasoning via Perplexity
morph-apply
Fast file editing via Morph Apply API (10,500 tokens/sec, 98% accuracy)
loogle-search
Search Mathlib for lemmas by type signature pattern using Loogle.
github-search
Search GitHub code, repositories, issues, and PRs via MCP
elasticsearch-patterns
Mapping design, query optimization, aggregation patterns, index lifecycle management, and search relevance tuning.
search-hierarchy
Search Tool Hierarchy