workspace-repo-map 0.2.0

Compact JSON repository inventory maps for multi-repo workspaces.

Workspace Repo Map

Compact JSON repository inventory maps for multi-repo workspaces.

workspace-repo-map scans a workspace root for Git repositories and writes a compact JSON map of remotes, branches, dirty counts, marker files, and public or local-only classification hints.

Generated maps are portable by default: repository paths are root-relative, the local root is represented by a short hash, and credential-shaped material in remote URLs is always redacted. Dropping whole origins by class is opt-in via .repomap.toml.

Install

python -m pip install workspace-repo-map

Usage

workspace-repo-map --root . --output WORKSPACE-REPO-MAP.json
workspace-repo-map --json

Without --json, the map is written to <root>/WORKSPACE-REPO-MAP.json (or --output) and a one-line summary (wrote <path> / repos=N dirty=M) is printed.

Classification is driven by an optional .repomap.toml at the workspace root (see example.repomap.toml). With no config, repos are classified by a neutral remote-host heuristic: local (no remote), public (origin on a public host), or private. Here public means "origin is on a public code-hosting platform" — a heuristic, not a guarantee of visibility.

For a full install line, the complete flag list, the importable Python API, and worked examples with expected output, see USAGE.md. A runnable end-to-end demo lives in examples/demo.py.

Notes

• This CLI is agent assisted. Review output before sharing it in public.
• Repository names and branch details are exported from local git metadata.
• Absolute local root paths are not included by default.

---

Zain Dana Harper — small tools with explicit edges. Portfolio · HarperZ9 _{Built with Claude Code; reviewed, tested, and owned by me.}