Repo City

Repo City is a local npm CLI that turns pending git branches in a repository into an interactive 3D city report.

npx repo-city-cli

Run it from inside any git repository. By default it scans local git data and writes:

.repo-city/index.html

Open that file in a browser to view the report.

Trust Model

• The CLI runs readable TypeScript from src/ through tsx.
• The package exposes a tiny bin/repo-city.js bootstrap only.
• The shipped npm package includes bin, src, web, README.md, and LICENSE.
• No postinstall script.
• No telemetry.
• No network calls by default.
• Default behavior is local-only: read git data, write .repo-city/, print the local file URL.
• Any future network behavior must sit behind an explicit flag such as --publish.

Commands

npx repo-city-cli
npx repo-city-cli --max-age 30d
npx repo-city-cli --out ./my-report
npx repo-city-cli --from ./.repo-city

Development

npm install
npm run typecheck
npm test
npm run pack:check

Before publishing, inspect the dry-run package contents:

npm run release:check
npm publish --access public