RepoMetro

RepoMetro is a zero-cost, no-AI GitHub Action that analyzes a repository and generates a complete structured map — JSON, Markdown, and SVG visualizations — from repository metadata alone.

It never reads or includes file contents. It only analyzes metadata: file structure, languages, statistics, dependencies, tests, security signals, and Git history.

---

Why RepoMetro?

• Zero cost — runs entirely inside GitHub Actions, no external APIs, no AI, no tokens to buy.
• Private by design — never reads file contents, only metadata.
• Rich output — machine-readable JSON, human-readable Markdown, and SVG visualizations (tree, languages chart, treemap).
• PR integration — posts a summary comment on pull requests showing what changed.

---

Quick Start

Create .github/workflows/repometro.yml in your repository:

name: RepoMetro

on:
  push:
    branches: [main]
  pull_request:

permissions:
  contents: read
  pull-requests: write

jobs:
  repometro:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: kirasync/repometro@v1

RepoMetro will run on every push to main and on every pull request.

---

Documentation

• Usage Guide — inputs, outputs, examples, and configuration.
• Analyzers — the eight modular analyzers and what they detect.
• Architecture — how the monorepo is structured.
• JSON Schema — the structure of repometro.json.
• Security Model — what RepoMetro reads and what it never touches.