whatisgithub

What is archi?

mpraes/archi — explained in plain English

Analysis updated 2026-05-18

4GoAudience · developerLicenseSetup · easy

In one sentence

A local CLI tool that scans your codebase, scores its architecture, and shows metrics in a browser dashboard.

Mindmap

mindmap
  root((archi))
    What it does
      Scans codebase architecture
      Local dashboard
      Compares against last scan
    Tech stack
      Go
      Tree-sitter parsers
      Embedded web UI
    Use cases
      Module metrics
      CI architecture gate
      Export reports
    Audience
      Developers
      Less experienced coders
    Setup
      Single binary install
      Homebrew or direct download

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Scan a Go, JS/TS, or Python project and view architectural metrics in a local dashboard.

USE CASE 2

Compare a module's coupling, complexity, and size against the previous scan.

USE CASE 3

Export an architecture report as JSON or Markdown for documentation.

USE CASE 4

Block a CI pipeline merge automatically when a distance threshold is violated.

What is it built with?

GoTypeScriptPythonTree-sitter

How does it compare?

mpraes/archiaeneasr/github-trendsbxcodec/go-simple-flatbuffer
Stars444
LanguageGoGoGo
Last pushed2020-12-182017-06-09
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/52/5
Audiencedeveloperpm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Single static binary, AI enrichment is optional and needs a Gemini API key.

So what is it?

archi is a command line tool that scans a codebase and measures how well it is architected, then shows the results in a local dashboard that runs entirely on your own machine. It supports Go, JavaScript, TypeScript, and Python projects, including repositories that mix several of those languages, and it can either detect the language automatically or be told which one to use. It ships as a single binary with the web interface built in, so there is nothing extra to install once it is downloaded. Running the tool against a project opens a browser dashboard showing metrics for each module, along with how those numbers changed since the last scan. Clicking into a module reveals more detail on things like how tightly it is coupled to other parts of the code, whether it has become a bloated god module or an orphaned one nobody depends on, and how complex it is. If a source file has a syntax error, the tool warns about it and skips that file rather than stopping the whole scan. There is an optional AI enrichment step that adds extra insights on top of the computed metrics, using Google's Gemini model. This step only runs if an API key is supplied, and the dashboard's basic metrics load and display before the AI step even starts, so a slow or missing AI response never blocks the initial view. The README states that only the metric numbers are sent to the AI model, never the actual source code or the API key itself. Installation is available through several package managers depending on the operating system, including Homebrew, the Arch Linux AUR, the mise version manager, and direct DEB or RPM downloads, or the tool can be built from source using Go and npm. Beyond the interactive dashboard, archi also has headless commands meant for scripts and continuous integration pipelines: one exports a report as JSON or Markdown, and another checks the code against a distance threshold and exits with an error code if it is violated, which a team could use to block a merge automatically. The project is written in Go, with the web frontend embedded into the binary, and it is released under the MIT license. It is aimed at developers who want a quick, visual sense of a codebase's architectural health without manually digging through the code.

Copy-paste prompts

Prompt 1
Walk me through installing archi and running it against my project's codebase.
Prompt 2
Explain how archi's coupling and connascence metrics work for a Go module.
Prompt 3
Help me set up archi's check command in my CI pipeline to fail on architecture violations.
Prompt 4
How does archi's optional AI enrichment step work, and what data does it send?

Frequently asked questions

What is archi?

A local CLI tool that scans your codebase, scores its architecture, and shows metrics in a browser dashboard.

What language is archi written in?

Mainly Go. The stack also includes Go, TypeScript, Python.

How hard is archi to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is archi for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.