mcpField
M
mapping-codebases

mapping-codebases

github.com/oaustegardDevelopment157101 installsUpdated 1d ago
Repository

About mapping-codebases

mapping-codebases is a deprecated skill for generating persisted symbol maps of code repositories. Its README directs users to tree-sitting instead and describes the archived v0.8.0 release.

Key features

  1. 01Deprecated; use tree-sitting instead
  2. 02Previously generated per-directory _MAP.md files
  3. 03Archived v0.8.0 snapshot includes codemap.py and parser grammars

Use cases

  1. 01Refer to the archived mapping-codebases v0.8.0 release
  2. 02Replace persisted code maps with tree-sitting queries

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oaustegard/claude-skills --skill mapping-codebases

After installing, type/mapping-codebasesin Claude Code to confirm it loaded.

Bundled filesCHANGELOG.md

Details

From the project README

Mapping Codebases (deprecated)

Use tree-sitting instead.

Why

This skill wrote _MAP.md files to disk — a persisted symbol inventory per directory, generated once and read many times. That tradeoff made sense when scanning was expensive. It isn't: tree-sitting parses a 250-file repo in about 700ms and answers queries against the in-memory AST in under a millisecond.

A persisted map costs what a runtime scan does not — it goes stale, it needs regenerating, it gets committed, and it must be excluded from every other tool that walks the tree. Nothing was gained for that.

Replacement commands

TREESIT=/mnt/skills/user/tree-sitting/scripts/treesit.py

# Was: codemap.py /path/to/repo          → root orientation
python3 $TREESIT /path/to/repo

# Was: reading every _MAP.md in the tree → full inventory
python3 $TREESIT /path/to/repo --depth=-1 --detail=sparse

# Was: grepping _MAP.md for a symbol     → direct lookup
python3 $TREESIT /path/to/repo --no-tree 'find:parse_input'

The archived version

The last working release is mapping-codebases-v0.8.0 (2026-03-31). It carries scripts/codemap.py and the eleven bundled parsers/*.so grammars. The release is the snapshot; nothing in this directory reproduces it.

Note that v0.8.0 ships a latent bug: codemap.py:1216 calls an unimported get_parser() inside a try swallowed by a bare except Exception, so HTML inline-JavaScript symbol extraction silently returned nothing. It will not be fixed.

Comments

Markdown supported