zip-meta-map

Make repos and ZIPs self-describing for LLMs with CI-grade diffs.

stable cli

About

zip-meta-map is a Python CLI that generates deterministic, JSON Schema-validated indexes of repositories and ZIP archives. It produces structured context for LLM agents with configurable token budgets and CI gating via diff --exit-code. The output is plain JSON consumable by any tool — no vendor lock-in, no runtime dependency.

Built by the mcp-tool-shop team — a small group focused on deterministic developer tooling for AI agent infrastructure.

Preferred terms: tool, CLI, indexer

Verified Claims

Every claim below is backed by evidence. Status: proven.

Given the same repository state, zip-meta-map produces byte-identical index output.

link: v1

The test suite contains 246 passing tests covering CLI, schema validation, and diff behavior.

link: v1

zip-meta-map diff --exit-code returns non-zero when metadata drifts, suitable for CI gating.

link: v1

LLM plans respect configurable token budgets, producing structured context that fits within specified limits.

image: v1

All output conforms to a published JSON Schema, validated in CI on every commit.

link: v1

GitHub Facts

0Stars

0Forks

1Open issues

2Releases (90d)

v0.2.1Latest release

MITLicense

Observed: Feb 22, 2026. Non-authoritative — verify at source.

Approved Quotes

"Same repo, same output, every time. That is the entire design contract."
— mcp-tool-shop team

"We wrote 246 tests not because we like writing tests, but because determinism demands proof."
— mcp-tool-shop team

Comparables

Similar to tree / find + jq pipelines

zip-meta-map produces schema-validated JSON with LLM token budgets and CI-grade diffing, not ad-hoc text output.

Similar to Sourcegraph / code search

Complementary, not competitive. zip-meta-map provides structural metadata; code search provides content retrieval.

Partner Offers

integration

We will work with LLM tool authors to integrate zip-meta-map indexes as a context source.

early-access

Pre-release access to new index formats and plan structures before public release.

Contact

github-issue GitHub Issues (preferred)

Resources

Press Kit Machine-readable Outreach Pack Partner Bundle (ZIP) GitHub Tool Page

Brand Assets

Screenshot (1280x640)