Explore Codebase with Graph
tirth8205/code-review-graph
Navigates a codebase through the code-review-graph MCP tools: architecture overview, symbol search, caller and callee tracing, flows and oversized functions.
Semantic search for codebases. An agent skill from tmcfarlane/oh-my-cursor.
MITAuto-check passed
Install Exploring Codebases
$ npx skills add tmcfarlane/oh-my-cursor --skill exploring-codebases -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install tmcfarlane/oh-my-cursor exploring-codebases --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/tmcfarlane/oh-my-cursor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/exploring-codebases .claude/skills/exploring-codebases && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "exploring-codebases" agent skill from https://github.com/tmcfarlane/oh-my-cursor/tree/main/skills/exploring-codebases into .claude/skills/exploring-codebases/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-codebases", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/tmcfarlane/oh-my-cursor/tree/main/skills/exploring-codebasesType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add tmcfarlane/oh-my-cursor --skill exploring-codebases -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install tmcfarlane/oh-my-cursor exploring-codebases --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tmcfarlane/oh-my-cursor.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/exploring-codebases .agents/skills/exploring-codebases && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "exploring-codebases" agent skill from https://github.com/tmcfarlane/oh-my-cursor/tree/main/skills/exploring-codebases into .agents/skills/exploring-codebases/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-codebases", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add tmcfarlane/oh-my-cursor --skill exploring-codebases -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install tmcfarlane/oh-my-cursor exploring-codebases --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tmcfarlane/oh-my-cursor.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/exploring-codebases .cursor/skills/exploring-codebases && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "exploring-codebases" agent skill from https://github.com/tmcfarlane/oh-my-cursor/tree/main/skills/exploring-codebases into .cursor/skills/exploring-codebases/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-codebases", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/tmcfarlane/oh-my-cursor.git --path skills/exploring-codebases--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add tmcfarlane/oh-my-cursor --skill exploring-codebases -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install tmcfarlane/oh-my-cursor exploring-codebases --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tmcfarlane/oh-my-cursor.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/exploring-codebases .gemini/skills/exploring-codebases && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "exploring-codebases" agent skill from https://github.com/tmcfarlane/oh-my-cursor/tree/main/skills/exploring-codebases into .gemini/skills/exploring-codebases/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-codebases", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install tmcfarlane/oh-my-cursor exploring-codebasesInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add tmcfarlane/oh-my-cursor --skill exploring-codebases -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/tmcfarlane/oh-my-cursor.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/exploring-codebases .github/skills/exploring-codebases && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "exploring-codebases" agent skill from https://github.com/tmcfarlane/oh-my-cursor/tree/main/skills/exploring-codebases into .github/skills/exploring-codebases/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-codebases", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add tmcfarlane/oh-my-cursor --skill exploring-codebases -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install tmcfarlane/oh-my-cursor exploring-codebases --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tmcfarlane/oh-my-cursor.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/exploring-codebases .opencode/skills/exploring-codebases && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "exploring-codebases" agent skill from https://github.com/tmcfarlane/oh-my-cursor/tree/main/skills/exploring-codebases into .opencode/skills/exploring-codebases/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "exploring-codebases", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
exploring-codebases- GitHub stars
- 109
- Token cost
- ~1k tokens
- SKILL.md length
- 274 words
- Files
- 1
- Skills in repo
- 14
- Repo updated
- First seen
- Licence
- MIT
At a glance
Semantic search for codebases. An agent skill from tmcfarlane/oh-my-cursor.
- Works in 3 steps: mapping-codebases runs tree-sitter once… → exploring-codebases --use-maps uses… → No redundant AST parsing at search time
- Looking for specific implementations
- SKILL.md covers Progressive Disclosure, Installation, Usage and Options, plus 3 more sections
- Calls python and uv
What it does
Exploring Codebases is an agent skill from tmcfarlane/oh-my-cursor. Semantic search for codebases. Locates matches with ripgrep and expands them into full AST nodes (functions/classes) using tree-sitter or pre-generated MAP.md files. Returns complete, syntactically valid code blocks rather than fragmented lines. Use when looking for specific implementations, examples, or references where full context is needed.
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: Like “oh-my-opencode”, but for Cursor IDE. Multi-agent orchestration, natively, using nothing but a few config files. The licence is MIT.
When your agent uses it
- Looking for specific implementations
- References where full context is needed
Example prompts
- “/exploring-codebases”
Requirements
- Python 3
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- mapping-codebases runs tree-sitter once to generate _MAP.md files with symbol locations
- exploring-codebases --use-maps uses ripgrep + map data for context expansion
- No redundant AST parsing at search time
What it can do on your machine
Read from SKILL.md and the folder at commit 5bad458. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
pythonuv
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Exploring Codebases loads about 1k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 274 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from tmcfarlane/oh-my-cursor at commit 5bad458, republished under its MIT licence (© tmcfarlane). 274 words, ~1,046 tokens.
Download SKILL.mdSave it as
.claude/skills/exploring-codebases/SKILL.md (or your agent's skills folder).- name
- exploring-codebases
- description
- Semantic search for codebases. Locates matches with ripgrep and expands them into full AST nodes (functions/classes) using tree-sitter or pre-generated _MAP.md files. Returns complete, syntactically valid code blocks rather than fragmented lines. Use when looking for specific implementations, examples, or references where full context is needed.
- metadata.version
- 0.3.1
Exploring Codebases
Hybrid search tool that combines the speed of ripgrep with structural awareness from tree-sitter or pre-generated _MAP.md files. It finds matches and returns the entire function or class containing the match, de-duplicating results semantically.
Progressive Disclosure
By default, returns signatures only (docstrings + declarations without function bodies), reducing token usage by 10-20x. Use --expand-full to get complete implementations when needed.
Installation
uv venv /home/claude/.venv
# tree-sitter is optional if using --use-maps mode
uv pip install tree-sitter-language-pack --python /home/claude/.venv/bin/pythonUsage
# Default: signatures only with tree-sitter (efficient)
/home/claude/.venv/bin/python /mnt/skills/user/exploring-codebases/scripts/search.py "query" /path/to/repo
# Full implementations
/home/claude/.venv/bin/python /mnt/skills/user/exploring-codebases/scripts/search.py "query" /path/to/repo --expand-full
# Map-based mode: no tree-sitter required (#276)
# Requires _MAP.md files generated by mapping-codebases
/home/claude/.venv/bin/python /mnt/skills/user/exploring-codebases/scripts/search.py "query" /path/to/repo --use-mapsOptions
--glob pattern: Filter files (e.g.,*.py,*.ts)--expand-full: Return full implementations instead of signatures--json: Output JSON for machine processing (default is Markdown)--use-maps: Use pre-generated_MAP.mdfiles instead of tree-sitter for context expansion. Eliminates redundant tree-sitter parsing when maps already exist.
Map-Based Mode (v0.3.0)
When _MAP.md files exist (generated by mapping-codebases), use --use-maps to skip tree-sitter entirely:
mapping-codebasesruns tree-sitter once to generate_MAP.mdfiles with symbol locationsexploring-codebases --use-mapsuses ripgrep + map data for context expansion- No redundant AST parsing at search time
Benefits:
- Single tree-sitter execution per codebase (during map generation)
- Faster searches (no AST parsing overhead)
tree-sitter-language-packnot required at runtime- Maps serve as canonical index for both navigation and search
Recommended workflow:
# Step 1: Generate maps (one-time, or after code changes)
python /mnt/skills/user/mapping-codebases/scripts/codemap.py /path/to/repo
# Step 2: Search using maps (fast, no tree-sitter needed)
python /mnt/skills/user/exploring-codebases/scripts/search.py "query" /path/to/repo --use-mapsExamples
Find class signatures:
/home/claude/.venv/bin/python /mnt/skills/user/exploring-codebases/scripts/search.py "class User" /path/to/repoOutput:
class User:
"""User account model."""
...Find full method implementation:
/home/claude/.venv/bin/python /mnt/skills/user/exploring-codebases/scripts/search.py "def validate" /path/to/repo --expand-fullFind usage of process_data in Python files:
/home/claude/.venv/bin/python /mnt/skills/user/exploring-codebases/scripts/search.py "process_data" /path/to/repo --glob "*.py"Scope and Limitations
Returns structural code elements — functions, classes, methods, interfaces, enums, structs, traits, and modules across 11 supported languages (Python, JavaScript, TypeScript, Go, Rust, Ruby, Java, C, C++, PHP, C#).
Does not return:
- Import/require statements
- Module-level variable assignments or constants
- Standalone decorators (decorators attached to functions/classes are included with their parent)
- Type aliases or standalone type annotations
- Comments outside of functions/classes
For these non-structural elements, use plain ripgrep (via the Grep tool) directly.
© tmcfarlane, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/exploring-codebases of tmcfarlane/oh-my-cursor.
Open the folder on GitHubat commit 5bad458
Compare with similar skills
Exploring Codebases next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Exploring Codebases this skilltmcfarlane/oh-my-cursor | 109 | — | ~1k | Automated safety check: Pass | MIT | |
| Explore Codebase with Graphtirth8205/code-review-graph | 32k | 1 repos | ~335 | Automated safety check: Pass | MIT | |
| Codebase Explorationgiancarloerra/SocratiCode | 3.3k | 1 repos | ~1.5k | Automated safety check: Pass | AGPL-3.0 | |
| Codebase Exploreryologdev/yoyo-evolve | 1.9k | — | ~2.8k | Automated safety check: Pass | MIT | |
| Codebase Onboardingaffaan-m/ECC | 274k | 3 repos | ~2k | Automated safety check: Pass | MIT | |
| Repomix Codebase Exploreryamadashy/repomix | 29k | 1 repos | ~2.7k | Automated safety check: Pass | MIT |
Similar skills
Codebase Exploration
giancarloerra/SocratiCode
Explore and understand codebases using SocratiCode semantic search, dependency graphs, and context artifacts.
Codebase Explorer
yologdev/yoyo-evolve
Builds a structural map of a large or unfamiliar codebase by dispatching sub-agents to summarize regions, keeping the main context small.
Codebase Onboarding
affaan-m/ECC
Analyze an unfamiliar codebase and generate a structured onboarding guide with architecture map, key entry points, conventions, and a starter CLAUDE.md.
Repomix Codebase Explorer
yamadashy/repomix
Packs a local or remote repository into a single AI-friendly file with the Repomix CLI, then reads and searches that output to explain structure, find patterns or report metrics.
Codebase Memory Exploring
DmNote-App/DmNote
This skill should be used when the user asks to "explore the codebase", "understand the architecture", "what functions exist", "show me the structure", "how is the code organized", "find functions…
More from tmcfarlane/oh-my-cursor
All 14 skills in this repoDocs Write
tmcfarlane/oh-my-cursor
Write documentation following Metabase's conversational, clear, and user-focused style.
Debugging
tmcfarlane/oh-my-cursor
Systematic 4-phase debugging with root cause investigation. An agent skill from tmcfarlane/oh-my-cursor.
Documentation Engineer
tmcfarlane/oh-my-cursor
Technical documentation expert for creating clear, comprehensive documentation.
Planning
tmcfarlane/oh-my-cursor
Technical implementation planning and architecture design. An agent skill from tmcfarlane/oh-my-cursor.
Codebase Search
tmcfarlane/oh-my-cursor
Search and navigate large codebases efficiently. An agent skill from tmcfarlane/oh-my-cursor.
Cursor Image Generation
tmcfarlane/oh-my-cursor
Generate and iterate images in Cursor using the built-in image model and strong prompts.
Questions about Exploring Codebases
What does Exploring Codebases do?
Semantic search for codebases. An agent skill from tmcfarlane/oh-my-cursor. Exploring Codebases is an agent skill from tmcfarlane/oh-my-cursor. Semantic search for codebases.
When should I use Exploring Codebases?
Exploring Codebases fits situations like: looking for specific implementations; references where full context is needed.
How do I install Exploring Codebases in Claude Code?
Run `npx skills add tmcfarlane/oh-my-cursor --skill exploring-codebases -a claude-code`. Or copy the skill folder (skills/exploring-codebases in tmcfarlane/oh-my-cursor) into .claude/skills/exploring-codebases in your project. Claude Code loads it when a task matches its description.
How do I install Exploring Codebases in Codex?
Run `npx skills add tmcfarlane/oh-my-cursor --skill exploring-codebases -a codex`. Or copy the skill folder (skills/exploring-codebases in tmcfarlane/oh-my-cursor) into .agents/skills/exploring-codebases in your project. Codex loads it when a task matches its description.
Can I use Exploring Codebases in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tmcfarlane/oh-my-cursor --skill exploring-codebases -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/exploring-codebases, .gemini/skills/exploring-codebases, .github/skills/exploring-codebases and .opencode/skills/exploring-codebases in your project.
What does Exploring Codebases need to run?
Going by SKILL.md and its folder, Exploring Codebases needs the command-line tools its instructions call (python and uv). Our summary lists: Python 3.
Does Exploring Codebases access the network?
SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Exploring Codebases safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Exploring Codebases use?
Exploring Codebases is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Exploring Codebases use?
About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Exploring Codebases?
Skills that share tags, products or a category with Exploring Codebases: Explore Codebase with Graph (tirth8205/code-review-graph, 32k stars), Codebase Exploration (giancarloerra/SocratiCode, 3.3k stars), Codebase Explorer (yologdev/yoyo-evolve, 1.9k stars) and Codebase Onboarding (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Exploring Codebases?
tmcfarlane (a GitHub user) maintains it in tmcfarlane/oh-my-cursor, which has 109 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on July 2, 2026.
Source: tmcfarlane/oh-my-cursor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.