# codebase-search

codebase-search finds where a feature lives in your repo and hands back absolute paths plus a short explanation of the flow.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1064 repo stars
- Author: jarrodwatts
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jarrodwatts/claude-code-config/tree/HEAD/agents/codebase-search.md
- Updated: 2026-01-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/codebase-search

## What it does

Ask it where something lives and it goes looking. The first move is several tool calls at once: grep for text, glob for filenames, LSP for definitions. One request covers matches and symbols together.

It runs on `haiku` and never writes or deletes files. The main agent handles the patch; this one maps the ground. GitHub examples arrive through the grep-app MCP server, with context7 and exa wired in alongside. Treat those hits with care, since they can come from a different library version, and the agent checks them against local search before reporting.

Every reply closes with a `<results>` block: absolute paths, an answer to the underlying need, and suggested next steps.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/codebase-search.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/codebase-search.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/codebase-search.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jarrodwatts/claude-code-config/tree/HEAD/agents/codebase-search.md

## When to use it
- locate the auth implementation
- list every call site of a function before a refactor
- work out which files handle payment processing
- get absolute paths you can open straight from the terminal
- see how open-source repos solved the same problem

## Example prompts
- Find where the login flow is implemented and explain it
- List every file that calls `validateUser`
- Which files handle payment processing?

## Similar
- [morph-search](https://affpapa.org/en/nevibecode/skills/morph-search.md) — skill · 493 installs
- [code-search](https://affpapa.org/en/nevibecode/agents/code-search.md) — subagent · ★ 763 repo stars
- [search-tools](https://affpapa.org/en/nevibecode/skills/search-tools.md) — skill · ★ 3951 repo stars
- [Vercel Grep](https://affpapa.org/en/nevibecode/mcp/vercel-grep.md) — MCP server · 1219 installs
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 49004 repo stars
- [Octocode MCP - AI Context Platform](https://affpapa.org/en/nevibecode/mcp/octocode-mcp-ai-context-platform.md) — MCP server · ★ 966 repo stars

From the same set: [jarrodwatts/claude-code-config](https://affpapa.org/en/nevibecode/by/jarrodwatts/claude-code-config.md) — 20 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
