skills.rest
AZidan
AZidanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

codemap

Locate symbols and file structures in codebases using pre-built structural indexes.

28|4|Updated Mar 12, 2026
Search Tags:#cli#code exploration#code index#symbol search#codebase navigation#token reduction#codemap
One-click install
npx skills add https://github.com/AZidan/archflow --skill codemap-azidan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codemap
Source: https://github.com/AZidan/archflow/tree/main/.claude/skills/codemap
Command: npx skills add https://github.com/AZidan/archflow --skill codemap-azidan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires codemap.

What problem does it solve? Reading entire files to find a single class or function wastes context tokens and slows down code exploration. This Skill uses pre-built structural indexes to pinpoint exact line ranges of symbols, reducing token consumption by 60-80% during codebase navigation. ## Core Features & Use Cases - Symbol Search: Find classes, functions, methods, interfaces, types, and enums by name with case-insensitive matching and type filters. - File Structure Inspection: Display all symbols in a file with their line ranges and signatures before reading any code. - Index Validation: Check whether cached line numbers are still accurate after file changes, with watch mode for automatic index updates. - Use Case: When asked to fix a login bug, run a symbol search for "login" to get the exact file and line range of the handler, then read only those lines instead of scanning the whole file. ## Quick Start Ask the agent to find where the UserService class is defined using codemap and read only its relevant lines.

Frequently Asked Questions about codemap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find where a function or class is defined in a large codebase?▼

Run codemap find with the symbol name to get the exact file path and line range, such as src/services/user.ts:15-189. Then read only those lines instead of scanning the entire file.

How do I see the structure of a file before reading it?▼

Run codemap show with the file path to list all symbols in the file with their types, line ranges, and signatures. This reveals classes, methods, and nested functions without loading the file content.

Why should I not install codemap from PyPI?▼

The PyPI package named codemap is a different, unrelated project. Install it with pip using the pinned GitHub URL git+https://github.com/AZidan/[email protected] to get the correct tool.

How do I keep the codemap index up to date after editing files?▼

Start watch mode with codemap watch . in the background so the index updates automatically whenever files change. You can also run codemap validate on a file to check whether its cached line numbers are stale.

When should I read full files instead of using the symbol index?▼

Read full files when you need implementation details, when making edits to code, or when the symbol is not in the index because the file is new or untracked. The index is for navigation, not for understanding logic.

Related Skills

Explore More Software Engineering Skills→
ulpi-ioulpi-io
13

codemap

Search code, locate symbols, and analyze dependencies via the codemap CLI.

Official
Intermediate
Archive228Archive228
746

bisect-regression

Locate the commit introducing a regression by bisecting commits and running tests.

Community
Advanced
jmylchreestjmylchreest
15

code-search

Search indexed codebases for symbol definitions, locations, and call sites.

Community
Intermediate
jamescjamesc

use-lsp

Navigate TypeScript and Rust code via Language Server Protocol.

Community
Intermediate