repo-architect

Your codebase, documented. Automatically. Every night.

npx repo-architect
How it works

One command. Full architecture docs.

1

Scan

Repomix extracts your entire codebase into a structured format — any language, any framework.

2

Analyze

Claude reads the full codebase and identifies modules, data flows, dependencies, and key abstractions.

3

Render

Generates Markdown docs with Mermaid diagrams — system maps, sequence diagrams, class diagrams, and more.

Features

Everything you need to keep docs in sync

Mermaid Diagrams

System maps, data flows, dependency graphs, class diagrams. Renders natively on GitHub.

Incremental Updates

Only regenerates docs when structural changes are detected. Preserves your hand-written notes.

Nightly PR

GitHub Action runs every night, opens a PR with updated docs. Zero maintenance.

Local Viewer

Interactive HTML viewer with zoom/pan diagrams, dark theme, and sidebar navigation. --view

Real output

Generated from repo-architect's own codebase

Get started

Up and running in 30 seconds

$ npx repo-architect

  repo-architect - documenting your codebase

  ✔ Scanned 142 files
  ✔ Identified 8 modules
  ✔ Wrote 9 files

  Generated files:
    + docs/architecture/OVERVIEW.md
    + docs/architecture/modules/api.md
    + docs/architecture/modules/auth.md
    ...

  Done! Docs at docs/architecture/

$ npx repo-architect --view
  Viewer running at http://127.0.0.1:3333
npx repo-architect npx repo-architect --view