repo-map

name

repo-map

description

Mechanical facts about a Python repo or a workspace of related repos — in one tool call, instead of N grep/read calls. `scripts/profile.sh <path>` returns: package name, version, repo path, manifest type + language, entry points, runtime + dev deps, flat package layout, depth-2 package tree, build_test (test cmd + coverage gate + python_requires), ci_workflows, publish_target (PyPI/GHCR + trigger), git_remote (host/owner/repo parsed from origin), module_summaries (per-module first-docstring-line summaries), vendored skills with upstream provenance, last 3 changelog entries, CITATION.md table, CLAUDE.md "Project status" body, extras (culture nick, …); with default online enrichment, also returns `github_state` (latest release, open issue count, default branch, CI status on default) and `pypi_state` (published version + release date). Pass `--basic` to skip Tier-2 and return Tier-1 mechanical facts only. Add `--depth deep` for: README intro, design-related CLAUDE.md sections, last 10 commit subjects. `scripts/connections.sh <path> --depth N` returns typed import / cite / vendor edges N hops out, plus each neighbor node (add `--profile` to inline each node's profile). `scripts/graph.sh [<root>…]` returns every repo + every edge in the workspace plus a mermaid diagram. Markdown by default; `--json` for machine-readable. Prefer this over multiple Read/Bash calls whenever you need ≥2 of those fields — one call beats N reads on both tokens and reliability, and the output is deterministic so you don't have to defend grep-based guesses.

repo-map

Three verbs, scaling from cheap (one repo, mechanical facts) to opt-in expensive (entire connected component with deep mind-model materials):

Mode	Invocation
One repo, mechanical facts	scripts/profile.sh <path>
One repo, mind-model materials	scripts/profile.sh <path> --depth deep
Walk N hops from a repo	scripts/connections.sh <path> --depth N