archify

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

Official channels： archify.si · GitHub
Archify is free and open source. Third-party online services and paid plans are operated by their respective providers and do not represent Archify. Service details →

Start with an idea, a question, or a plan. Describe it to your AI agent, and Archify turns it into an interactive HTML you can explore, customize, and share. From travel itineraries and learning maps to complex systems—make it your own.

See what the community is creating—and imagine what you could make next.

Live demos  ·  Get started  ·  Scenario guide  ·  Community  ·  简体中文  ·  日本語  ·  한국어

❤️ Partners & sponsors: Kimi Work · Supercode · OpenLux

See Archify in action

https://github.com/user-attachments/assets/78570807-ba1d-4737-953f-55504a378a87

One sentence. Your repo, mapped. Watch the 35-second demo: explore the diagram, follow source links, and trace a path. Try the interactive examples ↗

Install, then describe your idea

Works with Cursor, Claude Code, Codex CLI, and OpenCode. See installation options below for additional integrations.

npx skills add tt-a1i/archify -g

Send this to your agent:

Use Archify to diagram a web request: Browser calls the API,
the API checks Redis, and a cache miss queries PostgreSQL and fills the cache.

Then continue: “Add authentication”, “Highlight the cache-miss path”, or “Switch to the light theme”.

No repository is required: start with a description, or ask your agent to read a repository for a source-backed architecture diagram.

Choose your agent · Installation details and update checks · Create and check diagrams with your agent

Ask a question, get a one-page answer

Not every answer is one diagram. Ask your agent to answer as a page and Archify builds an explainer: the conclusion first, then one panel per question, with tables, steps, charts, code and validated diagrams.

• Conclusion first. The answer and its reasons lead; every panel takes one question.
• Diagrams that explain. Steps sit beside the diagram they walk through and light its parts as you read. Click any node to open the full interactive view.
• Easy to check. Claims cite numbered sources; repository excerpts are pinned to a commit and open in a source card.
• Easy to share. One HTML file with four styles and light or dark themes. Export a PNG, WebP or JPG long image, or print to PDF. Ask about any panel to get a follow-up your agent can use to revise just that panel.

Use Archify to answer as one page: our API's P99 went from 80 ms to 600 ms
while the mean barely moved. What is the likely cause, and how should we investigate?

Live examples: First HTTPS visit · P99 latency (Chinese) · How Archify finalize keeps the last good file, read from this repository (Chinese) · First rental checklist (Chinese)

❤️ Sponsors

Archify × Kimi Work. Find Archify in the Kimi Work plugin store as Interactive Architecture Diagram. Describe your system in one sentence to create an interactive diagram. Try it in Kimi Work →

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 →
EverMind · Raven	EverMind sponsors Archify and builds memory infrastructure for agents. Its Raven harness supports Archify as a Skill for verified, interactive system maps.

Want to sponsor Archify? Contact us by email.

Show what matters

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.

The Proof Lab contains all 11 checked-in scenarios, their JSON sources, and validation receipts.

Understand a real repository

_{CODE → DIAGRAM · A source-backed system map}

Archify traced mco-org/mco at 9f1a1cf and produced this checked map. Open it ↗ · trace reach ↗ · typed source

Easy to extend. More ways to make it yours.

_{COMMUNITY STORIES · Selected examples shared by users}

Keep building after the diagram is generated. Archify is open source and its output is standalone HTML. Ask your agent to adapt it, connect useful links, or add interactions for your own workflow. Community creations already span team collaboration, travel planning, legal citation checks, contract review, and incident retrospectives. These are just a few examples.

One user started with a hand-drawn multi-agent architecture, turned it into an interactive diagram, then added a Kimi execution pool through conversation. Others asked their agent to read a project and brought the resulting architecture into Feishu or DingTalk for team discussion.

Another user turned a Shanghai CityWalk guide into a four-day itinerary: switch between days, inspect a stop, and jump to Amap, Xiaohongshu, or Dianping. The author also added arrival check-ins and stop notes, turning the itinerary into a small tool to use during the trip. These extensions were added by the community author for this particular artifact.

▶ Explore the interactive Shanghai CityWalk

▶ Try the interactive version · Switch between D1–D4 and click a place to explore.

_{Community artifact · Shanghai CityWalk · Four days of routes and place links}

Download it. Open it. Explore it.

The output is a self-contained HTML file. Download it and open it in your browser to use the node details and path exploration included in that artifact. No Archify installation is needed to view it. Send the HTML to someone else and the interactions go with it; external websites and map links need a network connection.

Explore the Shanghai CityWalk ↗ · Download HTML ↓

_{Try switching between D1–D4, opening a place card, or following a map link. Times and place information reflect the author's original itinerary.}

Community and recognition

• #1 on GitHub Trending's weekly, all-language repository list. Ranking screenshot published by the creator on September 1, 2026, with all languages and “This week” selected.
• Featured and interviewed by QbitAI. Project feature · The developer's story.
• Shared with developer communities. midudev's post.

_{A selection of public coverage, community shares, and historical milestones. Follow the links for dates and sources.}

Preview

Themes, exports, and share cards

Same diagram, two themes, one click to switch:

Dark	Light

The Export menu copies PNG to the clipboard and downloads static or motion formats:

After tracing a route, Export → Route Share Card downloads that authored path as a 1200×630 PNG with the full diagram retained for context.

After tracing authored Upstream or Downstream reach, Export → Reach Share Card captures that exact reading without claiming runtime impact.

Open examples/web-app.html locally to try the complete viewer.

Quick start

Current stable version: v3.2.0. See Changelog.

1. Install

npx skills add tt-a1i/archify -g

npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

npx skills use tt-a1i/archify@archify --agent codex

Stay updated

• Get release notifications: select Watch → Custom → Releases at the top of this GitHub repository. Starring the project does not subscribe you to release notifications.
• See what changed: Release notes.
• Use a feed reader: Subscribe to the release feed.

Installations with the update checker also check for newer stable releases during diagram delivery and can show a reminder. Older installations without the checker need a manual update to gain this feature. You choose whether and when to upgrade; Archify never installs updates automatically.

2. Start from a description — no repository required

Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.

For source evidence, open a repository and ask:

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.

3. Refine in chat

Continue with focused requests such as add Redis, move auth to the left, or highlight the rollback path. Archify keeps the typed source available for targeted iteration.

Choose the right diagram

node archify/bin/archify.mjs guide "Show an API request with Redis cache miss"
node archify/bin/archify.mjs guide "Map Kafka topics, consumer groups, replay, and DLQ" --json

Why Archify

How it works

cd archify
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
node bin/archify.mjs guide "Show CI/CD checks, approval, deploy, and rollback"
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs preview workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json

{
  "meta": {
    "locale": "en",
    "animation": "trace",
    "visual_preset": "signal-flow"
  }
}

Explore and share the output

Stable links can restore #focus=<id>, #focus=<id>&reach=upstream|downstream, #relation=<id>, #route=<source>~<target>, and #lens=<kind>~<kind>. Live repeats connection flow until paused; semantic previews remain bounded. Motion respects prefers-reduced-motion and never enters canonical exports.

The complete generation and viewer contract lives in archify/SKILL.md.

Installation options

Reference and scope

• Schema reference · Skill · Examples · Agent cookbook
• Changelog
• Roadmap
• Generated Proof Lab

Automatic Mermaid parsing, general-purpose auto-layout, hosted sharing, and WYSIWYG editing are intentionally outside the current scope.

Community

👋 Welcome to the Archify Community!

Connect with other users and developers, share ideas, request features, report bugs, discuss development, and help make Archify better together.

• Discord
• WeChat: scan the QR code below. WeChat group codes expire periodically; if this one has expired, ask for the current code through Discord or QQ.
• QQ group: 1121948602

WeChat

QQ

Official channels and third-party services

• Open-source project: Current source and packages built from it are available under the Apache License 2.0; previously published releases retain their original licenses.
• Official website: archify.si currently provides project information, examples, and installation guidance.
• Third-party services: Pricing, data handling, and support are determined by the respective provider. A similar name or domain does not establish an official affiliation.

License

Apache-2.0 — free to use, modify, and distribute.

Historical MIT grants remain in effect; see NOTICE and LICENSE-MIT. Third-party components retain their own licenses. The software license does not change ownership of your authored content or grant general permission to use Archify trademarks.

Contributing

Building a standalone package on Archify? Submit it to the community catalog; the guide includes a collapsible example and complete Chinese steps.

Issues, pull requests, and real-world diagrams are welcome. Start with the contribution guide, use the reproducible bug form for failures, or submit a validated diagram through the community showcase form. · LINUX DO

Support Archify

If Archify has been useful to you, you can support its continued development. Thank you for helping keep the project going ❤️

Using Archify, sharing it, reporting bugs, and contributing improvements are also ways to help.

Contributors

Thanks to everyone who helped build Archify. Go follow them. ❤️

Star History

把你想理解、规划或分享的事，变成可以互动的可视化作品。

官方入口： archify.si · GitHub
Archify 开源免费。第三方提供的在线服务、收费套餐由其运营方负责，不代表 Archify 官方。 查看详细说明 →

从一个想法、一个问题或一份计划开始。把它描述给 AI Agent，Archify 就能生成可以探索、修改和分享的交互式 HTML。从旅行行程、知识地图到复杂系统，你都可以继续扩展，做成自己需要的样子。

看看社区正在创造什么，也想想你还能用它做些什么。

交互演示  ·  开始使用  ·  场景指南  ·  社区交流  ·  English  ·  日本語  ·  한국어

❤️ 合作与赞助伙伴：Kimi Work · Supercode · OpenLux

看看 Archify 能做什么

https://github.com/user-attachments/assets/88cff7dd-bdf3-4b97-950c-37cc079898b1

一句话，看懂你的项目。 35 秒演示：探索交互图、查看源码关联、追踪完整路径。试试可交互示例 ↗

安装，然后说出你的想法

支持 Cursor、Claude Code、Codex CLI 和 OpenCode；更多接入方式见下方安装选项。

npx skills add tt-a1i/archify -g

把这句话发给你的 Agent：

用 Archify 画出一个网站的请求流程：浏览器请求 API，
API 优先读取 Redis，缓存未命中时查询 PostgreSQL 并回填缓存。

继续说：“添加鉴权步骤”“突出缓存未命中的路径”“切换浅色主题”。

**不需要绑定代码库：**从描述开始即可。也可以让 Agent 阅读仓库，生成有源码依据的架构图。

按 Agent 选择安装方式 · 安装细节与更新检查 · 用 Agent 画图并检查结果

问一个问题，得到一页讲清楚的答案

不是每个答案都是一张图。让 agent 用一页来回答，Archify 会生成一份 explainer：先给结论，再按问题分成几个面板，用表格、步骤、图表、代码和经过校验的图把理由讲清楚。

• 结论先行。 先写答案和理由，每个面板只回答一个问题。
• 图和文字一起讲。 步骤放在它讲解的图旁边，读到哪一步，图上就亮起哪一部分；点任意节点进入完整的交互图。
• 能核对。 结论标注编号来源；仓库代码固定到具体提交，悬停即可看到原文。
• 好分享。 一个 HTML 文件，四种样式，浅色深色都有；可导出 PNG、WebP、JPG 长图或打印成 PDF。对任何面板都能追问，生成的追问让 agent 只改这一块。

用 Archify 一页回答：接口 P99 从 80 ms 涨到 600 ms，平均值几乎没变，
可能是什么原因，应该怎么排查？

在线示例：P99 延迟排查 · 读 Archify 仓库：finalize 怎么保住旧产物 · 第一次租房要确认什么 · 第一次打开 HTTPS 网站（英文）

❤️ 赞助伙伴

Archify × Kimi Work。 在 Kimi Work 插件商店搜索 「可交互架构图」，用一句话描述你的系统，即可生成可交互的图。在 Kimi Work 中使用 →

supercode.sh	Supercode 赞助 Archify，通过 Token 优化、精选 Skills 和规范驱动开发增强 Codex 与 Cursor。Archify 已入选 Supercode Editor’s Choice 技能。
OpenLux	感谢 OpenLux 对本项目的赞助！OpenLux 是一个面向企业的一站式 AI 聚合平台，汇集全球各大厂商主流大模型，平台提供高效、稳定的服务与及时的技术支持。Claude、OpenAI、Gemini 系列模型基准折扣分别低至官方的 0.882 折、0.4 折和 0.8 折。 Archify 用户还可享受专属福利：通过专属链接注册，充值最高可享 7.5% 优惠！ 立即体验 →
PackyCode	PackyCode 提供统一域名、统一密钥和智能容灾切换，一句话接入主流大模型，提供专属 Codex / Claude Code 高速通道。 新用户可获 $1 免费体验额度，首充享折扣，多分组折扣低至 2 折起。支持人民币 1:1 充值，无汇率加价或额外充值手续费。 立即体验 PackyCode →
AICodeMirror	感谢 AICodeMirror 赞助 Archify！AICodeMirror 提供 Claude / Codex / Gemini API 中转服务，支持企业级高并发、开票和 7×24 技术支持。Codex 通道低至基准价格 0.7 折，充值还有额外优惠。 Archify 专属福利：通过专属链接注册，可享首充 8 折。 立即体验 AICodeMirror →
Infistar.cc 无限星河	感谢 Infistar.cc 无限星河赞助 Archify！一个 API Key 覆盖文案、图片与视频创作，支持 GPT、Claude、Gemini、DeepSeek、通义千问、可灵等主流模型，无需分组。大模型低至官方 0.1 折，AI 生图低至 ¥0.06/张。 Archify 专属福利：通过专属链接注册即送 $5 体验额度，并享首充特惠。 立即体验 Infistar →
EverMind · Raven	感谢 EverMind 赞助 Archify。EverMind 专注 Agent 记忆基础设施，旗下 Raven 已支持 Archify Skill，让 Raven 工作流可以直接生成经过验证的交互式系统地图。

想赞助 Archify？欢迎通过邮件联系我们。

用图把事情讲明白

讲清 Agent 如何调用工具	跟随一次缓存回源请求	看清服务与数据库的关系
追踪一个步骤影响到的全部下游。	点亮 Web App 到数据库的路径。	聚焦后端与数据库之间已定义的连接。

Proof Lab 收录全部 11 个仓库内场景、JSON 源和校验回执。

看懂一个真实代码仓库

_{CODE → DIAGRAM · 有源码依据的系统地图}

Archify 追踪 mco-org/mco 的 9f1a1cf 版本并生成这张校验地图。打开成品 ↗ · 追踪下游 ↗ · Typed Source

易于扩展，社区还在不断创造新用法

_{COMMUNITY STORIES · 社区用户提供的部分案例}

生成之后，还可以继续创造。 Archify 开源，成品是独立 HTML，你可以让 Agent 在此基础上继续修改、接入链接、扩展交互，做出适合自己场景的作品。社区已经把它用到了团队协作、旅行规划、法律核验、合同审查和故障复盘；下面只是其中一部分。

一位用户从纸上手绘的多智能体架构开始，让 Agent 生成交互图，再通过对话加入 Kimi 执行池。另一些用户让 Agent 阅读项目，把生成的架构图带进飞书或钉钉，继续和团队讨论。

还有用户把上海 CityWalk 攻略整理成了四天行程图：按天切换路线，点击节点查看地点信息，并跳转高德地图、小红书和大众点评。作者还扩展了到达打卡和停留记录，让一张路线图变成旅途中可以实际使用的小工具。这些扩展由社区作者为该作品添加。

▶ 点击体验上海 CityWalk 交互版

▶ 点击体验交互版 · 切换 D1–D4 行程，点击地点查看详情。

_{社区作品 · 上海 CityWalk · 四天行程与地点链接}

下载下来，亲手点一点

成品是一个独立的 HTML 文件。下载后用浏览器打开，即可使用该作品包含的节点详情和路径探索，无需安装 Archify。把 HTML 文件发给别人，交互也会一起保留；外部网站和地图链接需要网络。

打开上海 CityWalk 交互版 ↗ · 下载 HTML ↓

_{试试切换 D1–D4、点击地点卡片，或打开地图链接。行程中的时间和地点信息为作者创作时的记录。}

社区与关注

• GitHub Trending 全球仓库周榜第一。 作者于 2026 年 9 月 1 日发布的榜单截图，筛选为所有语言、This week。
• 量子位报道与人物采访。 项目报道 · 开发者故事。
• 开发者社区推荐。 midudev 分享。

_{这里选列部分公开报道、分享与历史里程碑；排名日期及来源见链接。}

预览

深浅主题、导出菜单与分享卡片

同一张图，两套主题，一键切换：

深色	浅色

Export 菜单支持复制 PNG，并下载静态或动态格式：

路径解析后，Export → Route Share Card 会把真实路径下载为 1200×630 PNG，并保留完整拓扑上下文。

完成 authored Upstream 或 Downstream reach 后，Export → Reach Share Card 会捕获这次阅读结果，但不冒充运行时影响分析。

在本地打开 examples/web-app.html，即可体验完整 Viewer。

快速开始

当前稳定版本： v3.2.0。详见版本历史。

1. 安装

npx skills add tt-a1i/archify -g

npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

npx skills use tt-a1i/archify@archify --agent codex

获取更新

• 订阅新版本： 在本 GitHub 仓库顶部选择 Watch → Custom → Releases，订阅版本发布通知。点 Star 不会自动订阅更新。
• 查看更新内容： 版本说明。
• 使用 RSS 阅读器： 订阅版本更新源。

带有更新检查器的安装版本，也会在交付图时检查新的稳定版，并可显示提醒。不带检查器的旧安装需要先手动更新，才能获得这项功能。是否升级、何时升级由你决定，Archify 不会自动安装更新。

2. 直接从描述开始——不需要代码库

用 Archify 画出：Browser -> API -> Redis 缓存 -> PostgreSQL 回源。

需要源码证据时，打开仓库后改用：

分析这个仓库，然后使用 archify 生成一张高层运行时架构图。
只保留 8–12 个核心组件，突出一条主要路径，并标出外部依赖与信任边界。
辅助信息放进说明卡片，不要继续增加连线。

3. 在对话中细调

继续说：增加 Redis、把鉴权移到左侧、突出回滚路径。Archify 会保留 Typed Source，只修改相关部分。

选择合适的图表

node archify/bin/archify.mjs guide "展示带 Redis 缓存未命中的 API 请求"
node archify/bin/archify.mjs guide "梳理 Kafka Topic、消费者组、重放和死信队列" --json

为什么用 Archify

工作原理

cd archify
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
node bin/archify.mjs guide "展示 CI/CD 检查、审批、部署和回滚"
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs preview workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json

{
  "meta": {
    "locale": "zh-CN",
    "animation": "trace",
    "visual_preset": "signal-flow"
  }
}

探索与分享

稳定链接可以恢复 #focus=<id>、#focus=<id>&reach=upstream|downstream、#relation=<id>、#route=<source>~<target> 和 #lens=<kind>~<kind>。动态模式持续播放连线流动，直到读者暂停；语义预览仍有限运行。动效遵守 prefers-reduced-motion，并且不会进入标准导出。

完整生成与 Viewer 契约请查看 archify/SKILL.md。

安装方式

参考与边界

• Schema 说明
• Skill 与 Renderer 契约
• 示例
• Agent 编图手册 · English
• 版本历史
• 路线图
• 自动生成的 Proof Lab

自动 Mermaid Parser、通用自动布局、托管分享服务和 WYSIWYG 编辑器目前都不在产品范围内。

社区交流

👋 欢迎加入 Archify 社区！

与其他用户和开发者交流、分享想法、提出功能建议、报告问题、讨论开发，并一起让 Archify 变得更好。

• 加入 Discord
• 微信群：扫描下方二维码。微信群二维码会定期失效；如二维码已过期，请通过 Discord 或 QQ 联系管理员获取最新二维码。
• QQ 群：1121948602

微信群

QQ 群

官方入口与第三方服务

• 开源项目： 当前源码及由其构建的安装包可按 Apache-2.0 协议使用；历史发行版保留原有许可。
• 官方网站： archify.si 目前提供项目介绍、示例和安装指引。
• 第三方服务： 是否收费、如何处理数据、提供什么支持，由第三方运营方决定。名称或域名相似不代表官方合作。

License

Apache-2.0 —— 可以自由使用、修改和分发。

历史 MIT 授权继续有效，见 NOTICE 和 LICENSE-MIT。第三方组件保留各自许可；软件许可不改变用户原创内容的权属，也不授予一般性的 Archify 商标使用权。

参与贡献

基于 Archify 做了独立包？提交到社区目录。详细步骤和 JSON 示例默认折叠，按需展开即可。

欢迎提交 Issue、Pull Request 和真实场景图。请先阅读贡献指南；遇到问题时使用可复现 Bug 表单，也可以通过社区 Showcase 表单提交已验证成品。

较大的功能或行为调整请先通过 Issue 对齐价值、兼容边界和非目标，再基于最新 main 开发。一个 PR 尽量只解决一个问题；核心代码和回归测试先行，生成物最后统一重建。Archify 坚持 Agent-first，优先完善稳定的机器可读诊断和现有权威合同，避免新增容易与 CLI 漂移的重复说明。 · LINUX DO

支持 Archify

如果 Archify 对你有帮助，欢迎支持项目的持续开发。谢谢你让这个项目继续走下去 ❤️

使用、分享、反馈问题和贡献改进，也都是对项目的支持。

贡献者

感谢每一位参与构建 Archify 的人。欢迎关注他们。 ❤️

Star History