~/guides/DIAGRAM.md

Guides / AI tools

Archify: one sentence and Claude Code turns your whole project into an interactive architecture diagram

Archify is a free, open-source Claude Code skill that reads your code and draws a diagram whose boxes link to the source. Install, prompt, paths, edits.

Watch the reel on InstagramComment #DIAGRAM to get this guide

When you take over a new project, the slow part is not writing code but understanding it: where the data comes in, which file does what, what a change will touch. Archify is a free, open-source (Apache 2.0) Claude Code skill that has Claude read your code and draw an architecture diagram you can click, with every box linked to the exact source lines. This is the full version of the DIAGRAM reel: a real diagram we made of the open-source nanoGPT project, how to install it, the one-sentence prompt, how to see the source and trace a path, how to change and share the diagram, and what to watch out for.

01The result first: one sentence turned the whole nanoGPT project into a diagram you can click

Reel frame: the Archify diagram of nanoGPT on the 3D laptop, the training row ringed in green
Real output: Archify read the open-source nanoGPT project and drew the whole flow from data to generated text.

When you are done, you will have:

  1. One HTML file: your project's architecture, its components, flows and where the data lives, on one page.
  2. Every box links to the source code; click it to see the exact file and lines.
  3. A path you can trace, to see where the data goes.
  4. No dragging to make changes: tell Claude in one sentence. Send the file to a colleague and they can open it and click around.
The Archify nanoGPT diagram: data, prepare.py, train.bin, train.py, ckpt.pt in a row; model.py, sample.py below
nanoGPT (karpathy/nanoGPT, commit 3adf61e) drawn with Archify 3.2.0 on 3 Nov 2026; all four checks passed.

02Step 1: Install Archify

Reel frame: the tt-a1i/archify page on GitHub, Star 92.9k ringed, a paper strip reading Apache 2.0, free
Archify on GitHub: Apache 2.0, about 93K stars on 3 Nov 2026.

Archify is an open-source skill by tt-a1i that works in Claude Code, Codex, Cursor and OpenCode. You need Node.js 18 or later. The easiest way is to let Claude Code install it: paste this line in.

Paste into Claude Code (official install line)
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt

Claude first tells you which commands it will run and asks whether to install for all projects or this one only, and installs after you confirm. To install it yourself in a terminal, use the official line (for Claude Code, all projects):

Install it yourself (terminal)
npx -y skills@latest add https://archify.si --skill archify --agent claude-code --global --copy --yes

03Step 2: Ask Claude in one sentence

Reel frame: the README prompt Analyze this repository ringed, a dark card with our Chinese prompt below
The prompt from the README, and the Chinese version we used.

Open Claude Code in your project folder and say:

Diagram the project (swap in the part you want)
Use Archify to analyze this project and draw an architecture diagram of [the whole project / the login flow / the checkout flow], with every component linked to its source code.

For a more precise result, use this one from the README:

The README version
Analyze this repository, then use archify to create a high-level runtime architecture diagram.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.
Put supporting detail in cards instead of adding more edges.

Archify checks the diagram's format, layout and connections first and writes the HTML only when every check passes; if something fails, it fixes it and runs again. Besides architecture it has ten types in all, including workflow, sequence, data flow, lifecycle and ERD; just say which one you want.

04Step 3: Click a box to see the source, trace a path

Archify HTML: train.py clicked, a card shows verified source nanoGPT @ 3adf61e, get_batch L116–131 and L255–314
Click train.py: the card lists the files and lines behind that box, pinned to one commit.

Open the HTML file in a browser and click any box: its source locations appear beside it, and one more click opens those lines on GitHub.

Reel frame: nanoGPT train.py on GitHub, lines 116 to 131 (get_batch) ringed in green, chip train.py L116–131
One click: train.py opens at lines 116 to 131.

A few useful keys:

  1. /: find any box.
  2. R (or Path, bottom right): pick a start and an end and trace a path.
  3. M: open a mini map of the whole diagram.
  4. F: presentation mode, the diagram fills the screen.
  5. S / T / E: change the style, switch light or dark, export an image.
Archify HTML: the path Tiny Shakespeare to ckpt.pt, 5 nodes in 4 steps, that row lit up
Trace a path: the data flows from Tiny Shakespeare to ckpt.pt, and only that path lights up.

05Step 4: Change it by asking, then send it to a colleague

Reel frame: README section 3. Refine in chat ringed, a sign crossing out drag-and-drop, a stamp: change it by asking
Archify is not a drag-and-drop drawing app; to change the diagram, keep talking to Claude.

Once the diagram is drawn, keep going in the same chat and say what to change:

Change the diagram (swap in your own)
Highlight the path to [sample.py], move [the database] to the right, and add [a cache].
Reel frame: a green HTML file slides to a small laptop labelled colleague's computer, whose screen lights up
One HTML file: your colleague needs no Archify, they open it and click.

The output is a single standalone HTML file; send it to someone and the interactive features go with it. Export (top right) also saves PNG, JPEG, WebP, SVG or a 6-second WebM animation for slides and docs.

06Good to know

  1. Open the HTML file in a browser to use it; opened on GitHub, it only shows a wall of source code.
  2. Source links exist only for diagrams drawn from code, and they point to the commit at drawing time; when the code changes, ask for the diagram again.
  3. It is not a drag-and-drop drawing app and has no mouse editing; change it by asking, and Claude edits the diagram data and redraws it.
  4. Drawing and checking run on your computer. It occasionally checks online for a new version (a reminder only, never an automatic update); set ARCHIFY_UPDATE_CHECK_DISABLED=1 to turn that off.
  5. The only official places are github.com/tt-a1i/archify and archify.si. There are forks with the same name on GitHub, and the sponsors in the README (such as API resellers) are third parties, not Archify.
  6. You found this page by typing DIAGRAM in the link in bio; there are no DMs.

Sources

Related guides