repowisett-a1i/archify

tt-a1i / archify

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

JavaScript★ 84,926
Use in your agentAsk this codebase

github.com/tt-a1i/archifyIndexed at 5de7275Up to date with upstream

What is archify?

archify is a Node.js rendering and validation system for turning codebases or system descriptions into interactive system maps. Agents create typed JSON intermediate representations, which archify deterministically compiles into HTML and SVG. The project is primarily written in JavaScript and also includes shell files.

Written by a model from the README and the source

349 files and 1,881 symbols in 6 modules, led by JavaScript (160 files) and Shell (2).

Start reading

Code health

6.0out of 10Fair

This codebase scores 6.0 out of 10 for code health, which we rate fair. It also scores maintainability 7.7 and static performance 9.3 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 33 of 349 files are git hotspots, and they average 3.7 — which is where the fixes pay off most.

Full health report

On the leaderboards:#15 of 16 JavaScript repos

Use tt-a1i/archify in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/tt-a1i/archify
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is archify put together?")
  • get_why("why is archify structured this way?")

Explore archify

Key features of archify

  • archify supports five diagram types, four presets, dark and light themes, built-in brand marks, and finite motion.
  • archify compares validated snapshots as Before, Delta, and After views with added, removed, changed, moved, and rerouted facts.
  • archify validates schemas, layouts, HTML or SVG output, routes, and label-to-route clearance before delivery.
  • archify returns machine-readable repair receipts with stable rule codes, subjects, measured evidence, and supported repair controls.
  • archify produces one portable HTML file, and exports remain full-diagram without temporary viewer state.

How tt-a1i/archify works

An agent creates typed JSON IR from a description, then bundled validators and layout rules check the source before rendering. The command-line entry point archify/bin/archify.mjs provides commands for diagnosis, generation, validation, preview, and delivery. The architecture renderer in archify/renderers/architecture/render-architecture.mjs produces architecture diagrams, while archify/renderers/workflow/render-workflow.mjs renders workflow diagrams. Shared geometry calculations are handled by archify/renderers/shared/geometry.mjs. An optional preview loop watches one JSON file and reloads only verified revisions, while delivery renders a same-directory candidate and atomically replaces the target after checks pass.

The codebase has 349 files and 1,881 symbols in 6 modules, led by JavaScript and Shell. Code health is 6.0 out of 10, rated fair.

Getting started with archify

  1. Install archify as a global skill.
    npx skills add tt-a1i/archify -g
  2. Install archify explicitly for Cursor without interaction.
    npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
  3. Try archify without installing it.
    npx skills use tt-a1i/archify@archify --agent codex
  4. Run the command-line diagnostic from the archify directory.
    node bin/archify.mjs doctor

Commands copied from the README

tt-a1i/archify FAQ

What is archify?

archify is a Node.js rendering and validation system that turns codebases or system descriptions into interactive HTML and SVG system maps. Agents provide typed JSON IR.

How does archify work?

archify validates typed JSON IR, renders diagrams, and delivers an artifact only after checks pass. Its CLI supports generation, validation, preview, and delivery.

How do I install archify?

Install archify with npx skills add tt-a1i/archify -g. Cursor also supports npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes.

What language is archify written in?

archify is primarily written in JavaScript. The repository also includes shell files.

How is the archify code organized?

archify is organized into archify, docs, integrations, scripts, benchmarks, experiments, root, and .github modules. Its CLI entry point is archify/bin/archify.mjs.

Who is archify for?

archify is for users of Cursor, Claude Code, Codex CLI, and OpenCode who need architecture, workflow, sequence, data-flow, or lifecycle diagrams.

What license does archify use?

archify uses the MIT license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of tt-a1i/archify from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.