tt-a1i/archify

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/tt-a1i/archify.svg?style=card)](https://bestofgithub.dev/repo/tt-a1i/archify)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/tt-a1i/archify.svg)](https://bestofgithub.dev/repo/tt-a1i/archify)

Loading README…

supercode.sh	Supercode sponsors Archify and enhances Codex and Cursor with token optimization, curated Skills, and spec-driven development. Archify is featured as a Supercode Editor’s Choice skill.
OpenLux	Thank you to OpenLux for sponsoring this project! OpenLux is an all-in-one AI platform for businesses, bringing together leading AI models from major providers worldwide. With fast, reliable service and responsive technical support, OpenLux offers base pricing for Claude, OpenAI, and Gemini models as low as 8.82%, 4%, and 8% of official rates, respectively. Exclusive offer for Archify users: Sign up through our referral link and enjoy up to 7.5% off credit top-ups! Get started with OpenLux →
PackyCode	Access leading AI models through PackyCode with one API endpoint and one API key. Enjoy automatic failover and dedicated high-speed routes for Codex and Claude Code. Get started with $1 in free credits, a discount on your first top-up, and savings of up to 80% on eligible routes. Pay in RMB with no currency conversion markups or extra top-up fees. Get started with PackyCode →
AICodeMirror	Thank you to AICodeMirror for sponsoring Archify! AICodeMirror provides API relay services for Claude, Codex, and Gemini, with enterprise-grade concurrency, invoice issuance, and 24/7 technical support. Codex pricing starts at 7% of standard rates, with additional top-up discounts. Exclusive offer for Archify users: Register through our referral link to receive 20% off your first top-up. Try AICodeMirror →
Infistar.cc	Thank you to Infistar.cc for sponsoring Archify! One API key covers text, image, and video creation with GPT, Claude, Gemini, DeepSeek, Qwen, Kling, and other models, without switching groups. Model API pricing starts at 1% of official rates, and AI images start at ¥0.06 each. Exclusive offer for Archify users: Sign up through our referral link for $5 in trial credits and a special offer on your first top-up. Try Infistar →

Explain an agent workflow	Follow a cache miss	Explore service relationships

Trace everything downstream of one step.	Highlight the path from web app to database.	Focus on authored backend and database connections.

Type	Best for	Include in your prompt
Architecture	Components, services, storage, boundaries	Scope, core components, primary path
Workflow	CI/CD, approvals, tool calls, runbooks	Participants, order, branches, exceptions
Sequence	API calls, cache fallback, auth, async traces	Callers, callees, returns, timing
Data Flow	Pipelines, lineage, PII, consumers	Sources, transforms, stores, boundaries
Lifecycle	States, retries, waits, terminal outcomes	States, events, retry and cancellation paths
ERD	Database schemas: tables, columns, keys, cardinality	Tables, every column with its type, primary/foreign/unique keys, relationship cardinality
Class	Classes, interfaces, selected members, type relationships	Types, key members, inheritance and implementations, composition, dependencies
Tree	Single-parent hierarchies: repositories, modules, capability breakdowns	Root, levels, what each branch contains
Timeline	When things happened: incident reviews, release histories	Timestamps with time zone, events, source lanes, whether times are observed or illustrative
Waterfall	Where the time went in one request or agent run	Spans, start times and durations, nesting, whether timings are measured or illustrative

Understand the structure	Walk through the story
Map components, workflows, and relationships from code or a description.	Explore nodes, follow paths, and share any view as a link.
Extend it your way	Share the result
Keep an editable source and build on the open-source code or generated HTML with your own interactions and use cases.	Share a self-contained HTML file or export images, video, and share cards.

Step	What happens
Generate	The agent creates typed JSON IR from your description.
Validate	Bundled validators and layout rules check the source; failures identify the exact local repair in machine-readable JSON.
Preview (optional)	A loopback-only desktop session watches one source and reloads only verified revisions; failures keep the last-good artifact.
Deliver	A same-directory candidate is rendered and checked; only a passing artifact atomically replaces the target, then optional `--open` launches that exact file.
Iterate	The agent updates the source while unrelated structure stays stable.

tt-a1i/archify

Turn anything you want to understand, plan, or share into an interactive visual.

See Archify in action

Install, then describe your idea

Ask a question, get a one-page answer

❤️ Sponsors

Show what matters

Understand a real repository

Easy to extend. More ways to make it yours.

Download it. Open it. Explore it.

Community and recognition

Preview

Quick start

1. Install

Stay updated

2. Start from a description — no repository required

3. Refine in chat

Choose the right diagram

Why Archify

How it works

Explore and share the output

Installation options

Reference and scope

Community

Official channels and third-party services

License

Contributing

Support Archify

Contributors

Star History

Action	Control
Open the factual Diagram Guide	`?`
Find and focus a semantic node	`/`
Trace upstream/downstream authored reach	Focus a node → `Upstream` / `Downstream`
Probe a directed route and inspect its journey	`R` or `PATH`
Compare one or two semantic roles	`L` or `LENS`
Open the live overview radar	`M` or `MAP`
Enter Presentation Stage	`F`
Choose visual style (`S` cycles) / toggle theme / open Export	`S` / `T` / `E`
Zoom or reset	`+` / `-` / `0`

Surface	Install location or method	Capability
Claude Code	`~/.claude/skills/` or `.claude/skills/`	Full renderer + validation workflow
Codex CLI	`~/.agents/skills/` or `.agents/skills/`	Full renderer + validation workflow
opencode	`~/.config/opencode/skills/`, `.opencode/skills/`, or `.agents/skills/`	Full renderer + validation workflow
Claude.ai	Upload `archify.zip` under Settings → Capabilities → Skills	Depends on Node.js access in the sandbox
Project Knowledge	Upload `archify.zip` to the project	Prompt-driven architecture fallback
Hermes Agent	Opt-in: `hermes skills install skills-sh/tt-a1i/archify/archify -y`	Community Skill-only integration; Node `>=18`; not a Nous official product. No telemetry. It is not a switcher target. Details.
DeepSeek Harness	Opt-in: `dsh plugin --profile web add @tt-a1i/archify-dsh@1.0.0`. Invoke: `Use the archify skill to map this repository's runtime architecture.` Remove: `dsh plugin --profile web remove @tt-a1i/archify-dsh`.	Community integration for developer-preview `@deepseek-ai/dsh@0.1.2-rc.1`; Node `^22.19.0 \|\| >=24.0.0`; not an official DeepSeek product. No telemetry. Shell files need exact workspace paths, not Web Produced Files. Details.