codemap
/codemap
Find where something lives in a git repo in one call before grepping or reading files. Use whenever you need to locate the file, function or line for a task ("where is X", "where does Y happen", "what calls Z", "what breaks if I change W"), including inside subagents doing code search.
- Author
- QDinvest ↗
- Repository
- Code-Map-QD ↗
- Licence
- MIT
- Last repository change
- 09.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 09.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Find where something lives in a git repo in one call before grepping or reading files. Use whenever you need to locate the file, function or line for a task ("where is X", "where does Y happen", "what calls Z", "what breaks if I change W"), including inside subagents doing code search.
Triggers from the description
Original author description
Find where something lives in a git repo in one call before grepping or reading files. Use whenever you need to locate the file, function or line for a task ("where is X", "where does Y happen", "what calls Z", "what breaks if I change W"), including inside subagents doing code search.
How it works
SKILL.md has no level-two headings · 19 lines, 221 words
SKILL.md preview
---
name: codemap
description: Find where something lives in a git repo in one call before grepping or reading files. Use whenever you need to locate the file, function or line for a task ("where is X", "where does Y happen", "what calls Z", "what breaks if I change W"), including inside subagents doing code search.
---
# codemap
Run from inside the repo (or pass `--root <repo>`). Use `python3` if `python` is not found.
```
python "${CLAUDE_PLUGIN_ROOT}/scripts/codemap.py" ask "<task in plain words> <4-8 words the code likely uses>"
python "${CLAUDE_PLUGIN_ROOT}/scripts/codemap.py" impact <file|symbol> # importers depth 2 + tests to run
python "${CLAUDE_PLUGIN_ROOT}/scripts/codemap.py" file <path> # outline instead of reading a big file
```
- Add 4-8 words the code probably uses: synonyms, identifier guesses, terms of art. Questions and code often use different words; this closes the gap (right function listed 91% with them, 75% without, on 110 test questions).
Example: `ask "where are passwords hidden in logs mask redact obfuscate sensitive secret"`.
- Output: the best files, one per line, each with its best functions as `name start-end`. Pick the function whose name fits and read only those lines.
- If no listed function fits but a file looks right, run `file <path>` and read only the function whose name fits. An outline costs a few hundred tokens; the whole file often costs thousands.
- If nothing fits, grep.
- Put exact strings in quotes or write routes as-is (`/api/x/y`). They are searched verbatim and every file containing them is listed.
- Paths are relative to the repo root. The first call in a repo builds the index (seconds), later calls take well under a second.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · QDinvest/Code-Map-QD | 96 | MIT |
| jordancoin/codemap | 100 | MIT |
| AZidan/archflow | 100 | MIT |
| alvinunreal/oh-my-opencode-slim | 100 | MIT |
| jordancoin/codemap | 100 | MIT |
| ils15/copilot-global-config | 100 | MIT |
| azidan/codemap | 100 | MIT |
| ialameh/sift-coder | 100 | MIT |
| jellydn/my-ai-tools | 96 | MIT |
Database snapshot: 13.11.2026 · package version abff094a93e5 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100repomap
Fast, dependency-free code index for any repository. Use it BEFORE grep, glob or reading whole files whenever you need to understand an unfamiliar repo, locate where a function, class or method is defined, see a file's structure, find who calls or imports something, or decide… - 100codemap-export
Use to export the codemap as machine-readable JSON for downstream tooling. Same data as /codemap, different format. "Export the codemap", "give me the codemap as JSON". - 90rc-codemap
Builds and refreshes per-directory codemap.md as a cheap structure map. Use before exploring a large repo. Do not use to trace one bug. - 100config-setup
Set up or tune .codemap/config.json so Codemap focuses on code-relevant parts of the repo. Use when config is missing, boilerplate, noisy, or mismatched to the stack. - 90glia-find
Find where a feature, symbol or concept lives in a codebase, as ranked nodes with path:line, then read their source. Use for "where is X", "find the code that handles Y", "which files is this task about", or to work out which files matter before reading any. - 100codemap-refresh
Use when code has changed since codemap files were generated and the user wants them brought up to date: "refresh", "update the diagrams", "docs are stale". Detects which docs/codemap files are outdated and regenerates only those, preserving manual edits.