代码关系图生成工具

grep "createOrder" → 8 files → read file 1 → see import → read file 2 → grep again...

codemap_query("createOrder") → defined in orders/service.ts, calls [validatePayment, calculateTotal],
                                called by [OrderController.create, checkout.handler]

# Install globally via npm
npm install -g @gingerdev/codemap-cli

# Or install as a project dependency (auto-creates Claude Code commands)
npm install @gingerdev/codemap-cli

# Generate a codemap for your project
cd /path/to/your/project
codemap init          # creates .codemaprc
codemap generate      # parses codebase, writes .codemap/

# Query from CLI
codemap query --search "createOrder"
codemap query --function "validatePayment"
codemap query --callers "UserService.create"
codemap query --class "OrderController"

# Connect to Claude Code via MCP
claude mcp add codemap -- codemap-mcp /path/to/your/project

codemap init                  # create config in current directory
codemap init --path ./myapp   # create config in a specific directory
codemap init --force          # overwrite existing config

codemap generate              # generate in current directory
codemap generate --path ./app # generate for a specific project

.codemap/
├── codemap.json       # Full structured data (classes, functions, call graphs, etc.)
├── codemap.md         # Compact root summary (~1500-2000 lines for large projects)
├── modules/           # Per-directory detailed markdown files
│   ├── src__core.md
│   ├── src__api.md
│   └── ...
└── .hashes            # Content hashes for change detection

codemap query --function <name>     # Query a function by name
codemap query --class <name>        # Query a class
codemap query --file <path>         # Query a file (partial match supported)
codemap query --module <dir>        # Query a directory/module
codemap query --type <name>         # Query a type/interface
codemap query --search <term>       # Search across everything
codemap query --callers <name>      # Show what calls a function
codemap query --calls <name>        # Show what a function calls
codemap query --json                # Output as JSON

codemap analyze --dead-code         # Detect unused functions and methods
codemap analyze --duplicates        # Detect redundant/duplicate functions
codemap analyze --circular          # Detect circular dependencies
codemap analyze --all               # Run all checks at once
codemap analyze --all --json        # Output raw JSON for scripting

codemap health                      # Show full health report
codemap health --summary            # One-line score only
codemap health --json               # Output raw JSON
codemap health --gate               # Exit code 1 if below threshold (CI mode)
codemap health --gate --threshold 80  # Custom minimum score
codemap health --no-degrade         # Fail if score dropped from last run

codemap diff                        # Show changes since last generation
codemap diff --update               # Show changes, then regenerate

{
  "include": ["."],
  "exclude": [
    "node_modules",
    "__pycache__",
    "dist",
    "build",
    "lib",
    ".git",
    ".codemap",
    "*.test.*",
    "*.spec.*",
    "*.min.*",
    "coverage",
    "vendor",
    ".next",
    ".nuxt",
    "venv",
    ".venv",
    "env",
    ".env",
    ".tox",
    "eggs",
    "*.egg-info",
    ".mypy_cache",
    ".pytest_cache",
    ".ruff_cache",
    "site-packages",
    "migrations"
  ],
  "projects": [
    "/path/to/project-a",
    { "name": "my-api", "root": "/path/to/project-b" }
  ]
}

# Single project
claude mcp add codemap -- codemap-mcp /path/to/your/project

# Multiple projects via CLI args
claude mcp add codemap -- codemap-mcp ~/Work/project-a ~/Work/project-b

# Multiple projects via .codemaprc (reads "projects" field)
claude mcp add codemap -- codemap-mcp

/codemap-find-reusable config parsing logic
/codemap-impact UserService.validate
/codemap-plan add WebSocket support

project         → name, languages, frameworks, entry points
files           → per-file: language, hash, exports, imports
classes         → per-class: file, extends, implements, decorators, methods, properties
functions       → per-function: file, params, return type, calls, called_by
types           → per-type: file, kind, extends, properties
call_graph      → caller → [callees]
import_graph    → file → [imported files]
dependencies    → package versions from manifests
config_deps     → env var usage across files

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup",
        "hooks": [
          {
            "type": "command",
            "command": "codemap check || codemap generate"
          }
        ]
      }
    ]
  }
}

codemap check              # shows which files changed
codemap check --quiet      # exit code only (0=fresh, 1=stale, 2=missing)

src/
├── cli/                  # CLI entry point and commands
│   ├── index.ts          # Commander setup
│   └── commands/         # generate, init, query, check, analyze, diff, health
├── core/                 # Core logic
│   ├── config.ts         # .codemaprc loading and defaults
│   ├── scanner.ts        # File discovery (fast-glob)
│   ├── orchestrator.ts   # Main pipeline: scan → parse → analyze → output
│   └── query-engine.ts   # Shared query logic (CLI + MCP)
├── parsers/              # Language-specific AST parsers
│   ├── parser.interface.ts
│   ├── typescript/       # ts-morph based
│   ├── python/           # web-tree-sitter WASM based
│   └── vue/              # Script extraction + TS delegation
├── analyzers/            # Structural analysis
│   ├── call-graph.ts     # Forward + reverse call graph with method resolution
│   ├── import-graph.ts   # File → imports mapping
│   ├── coupling.ts       # Module coupling metrics (afferent/efferent/instability)
│   ├── dead-code.ts      # Dead code detection from reverse call graph
│   ├── duplicates.ts     # Duplicate function detection
│   └── circular-deps.ts  # Circular dependency detection
├── frameworks/           # Auto-detection
│   └── detector.ts
├── output/               # Generators
│   ├── json-generator.ts # Full JSON output
│   └── md-generator.ts   # Compact MD + per-directory modules
├── mcp/                  # MCP server
│   ├── server.ts         # Multi-project MCP with stdio transport
│   └── formatters.ts     # Markdown formatters for MCP tool output
└── utils/
    ├── call-filter.ts    # Noise reduction (built-in filtering, type truncation)
    ├── logger.ts
    └── file-utils.ts