codemap

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

13|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/ulpi-io/browse --skill codemap-ulpi-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codemap
Source: https://github.com/ulpi-io/browse/tree/main/.agents/skills/codemap
Command: npx skills add https://github.com/ulpi-io/browse --skill codemap-ulpi-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hybrid vector+BM25 code search, symbol lookup, dependency analysis, PageRank importance scoring, coupling metrics, and circular dependency detection via the codemap CLI. Use when the user asks to search code, find symbols, analyze dependencies, find dependents, check coupling, view PageRank importance, detect circular dependencies, index a project, get file summaries, or explore architecture health. Wraps the @ulpi/codemap CLI (not MCP tools).

Core Features & Use Cases

  • Fast hybrid code search across large codebases using vector and BM25 techniques.
  • Symbol lookup and named references to quickly locate functions, classes, and types.
  • Dependency and coupling analysis, with PageRank-based importance scoring and circular dependency detection.
  • Project indexing, file summaries, and high-level architecture health views to guide refactoring.

Quick Start

Index your project if needed, then run codemap search <query> to locate symbols and dependencies.

Frequently Asked Questions about codemap

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

FAQPage Schema
How do I perform fast code search across a large codebase?

Symbol lookup finds functions, classes, and types by indexing your project and executing targeted search commands. This allows you to quickly locate named references across your entire codebase.

How do I detect circular dependencies and check architecture health?

Architecture health checks detect circular dependencies and calculate coupling metrics using the codemap CLI. This provides PageRank importance scoring to guide refactoring decisions.

Do I need the codemap CLI installed to analyze file dependencies?

Yes, dependency analysis requires the codemap CLI installed in your environment. The integration guides indexing and status checks before executing any analysis commands.

What is the best way to find which files depend on a specific module?

Finding dependents is best handled by applying dependency analysis commands within the codemap CLI. This identifies coupling metrics and references linked to your specific target module.

Can I get file summaries and explore architecture for projects of varying sizes?

Yes, codemap supports software projects of varying sizes by providing project indexing and file summaries. This generates high-level architecture health views to guide exploration.