Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

Document Codex and opencode skill installs

tt-a1i2736652e793a
diff --git a/README.md b/README.md
index ff3dadfd..97fad418 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
**Generate beautiful architecture, technical workflow, sequence, data-flow, and lifecycle diagrams in chat. Switch dark / light. Copy to clipboard or export crisp up-to-4× PNG / JPEG / WebP / SVG.**
-Archify is a [Claude Skill](https://support.claude.com/en/articles/12512180-using-skills-in-claude) that turns a plain-English description of your system or process into a polished, self-contained technical diagram — a single HTML file you can open, toggle themes on, copy to the clipboard, and export at maximum resolution.
+Archify is an agent skill for Claude, Codex CLI, and opencode. It turns a plain-English description of your system or process into a polished, self-contained technical diagram — a single HTML file you can open, toggle themes on, copy to the clipboard, and export at maximum resolution.
- **No design skills needed** — describe your architecture in English, get a diagram
- **Workflow, sequence, data-flow, and lifecycle diagrams too** — technical flows, approvals, tool calls, CI/CD, runbooks, request call chains, data pipelines, PII boundaries, and state machines can be drawn
@@ -16,7 +16,7 @@ Archify is a [Claude Skill](https://support.claude.com/en/articles/12512180-usin
- **Iterate by chat** — "add Redis", "move auth to the left", "use emerald for the API"
![License](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)
-![Claude](https://img.shields.io/badge/Claude-Skill-7C3AED?style=flat-square)
+![Agent Skill](https://img.shields.io/badge/Agent-Skill-7C3AED?style=flat-square)
![Version](https://img.shields.io/badge/version-2.6.0-0891b2?style=flat-square)
**Project page:** [tt-a1i.github.io/archify](https://tt-a1i.github.io/archify/)
@@ -117,7 +117,7 @@ Archify is based on [Cocoon-AI/architecture-diagram-generator](https://github.co
### 1. Install the skill
-> Requires Claude Pro, Max, Team, or Enterprise plan (or Claude Code).
+Archify is packaged as an agent skill directory (`archify/SKILL.md`), so the same [`archify.zip`](archify.zip) works with Claude, Codex CLI, and opencode.
**Claude.ai:**
1. Download [`archify.zip`](archify.zip)
@@ -134,10 +134,31 @@ unzip archify.zip -d ~/.claude/skills/
unzip archify.zip -d ./.claude/skills/
```
-The typed renderers (workflow / sequence / dataflow / lifecycle) rely on ajv for schema validation, which takes a one-time `npm install` in the skill directory. Claude installs it automatically on first use, following the Setup instructions in `SKILL.md` — or run it yourself:
+**Codex CLI:**
+```bash
+# Global (all projects)
+unzip archify.zip -d ~/.agents/skills/
+
+# Or project-local
+unzip archify.zip -d ./.agents/skills/
+```
+
+**opencode:**
+```bash
+# Global (opencode-native)
+unzip archify.zip -d ~/.config/opencode/skills/
+
+# Or project-local
+unzip archify.zip -d ./.opencode/skills/
+
+# Also works: the shared agent directory used above for Codex
+unzip archify.zip -d ~/.agents/skills/
+```
+
+The typed renderers (workflow / sequence / dataflow / lifecycle) rely on ajv for schema validation, which takes a one-time `npm install` in the installed skill directory. Many agent runtimes can run it automatically on first use, following the Setup instructions in `SKILL.md` — or run it yourself:
```bash
-cd ~/.claude/skills/archify && npm install
+cd ~/.agents/skills/archify && npm install
```
Without the dependency the renderers skip schema validation (layout checks still run).
@@ -150,6 +171,8 @@ What each install surface can do:
| Install surface | Capability |
|---|---|
| **Claude Code** | Full — runs the typed renderers + schema validation |
+| **Codex CLI** | Full — install to `~/.agents/skills/` or `.agents/skills/` |
+| **opencode** | Full — install to `.opencode/skills/`, `.agents/skills/`, or another supported skills directory |
| **Claude.ai (zip upload)** | Usually full — depends on whether the sandbox can `npm install`, which it typically can |
| **Project Knowledge** | Architecture mode only — no code execution, purely prompt-driven |
diff --git a/README_EN.md b/README_EN.md
index ff3dadfd..97fad418 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -4,7 +4,7 @@
**Generate beautiful architecture, technical workflow, sequence, data-flow, and lifecycle diagrams in chat. Switch dark / light. Copy to clipboard or export crisp up-to-4× PNG / JPEG / WebP / SVG.**
-Archify is a [Claude Skill](https://support.claude.com/en/articles/12512180-using-skills-in-claude) that turns a plain-English description of your system or process into a polished, self-contained technical diagram — a single HTML file you can open, toggle themes on, copy to the clipboard, and export at maximum resolution.
+Archify is an agent skill for Claude, Codex CLI, and opencode. It turns a plain-English description of your system or process into a polished, self-contained technical diagram — a single HTML file you can open, toggle themes on, copy to the clipboard, and export at maximum resolution.
- **No design skills needed** — describe your architecture in English, get a diagram
- **Workflow, sequence, data-flow, and lifecycle diagrams too** — technical flows, approvals, tool calls, CI/CD, runbooks, request call chains, data pipelines, PII boundaries, and state machines can be drawn
@@ -16,7 +16,7 @@ Archify is a [Claude Skill](https://support.claude.com/en/articles/12512180-usin
- **Iterate by chat** — "add Redis", "move auth to the left", "use emerald for the API"
![License](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)
-![Claude](https://img.shields.io/badge/Claude-Skill-7C3AED?style=flat-square)
+![Agent Skill](https://img.shields.io/badge/Agent-Skill-7C3AED?style=flat-square)
![Version](https://img.shields.io/badge/version-2.6.0-0891b2?style=flat-square)
**Project page:** [tt-a1i.github.io/archify](https://tt-a1i.github.io/archify/)
@@ -117,7 +117,7 @@ Archify is based on [Cocoon-AI/architecture-diagram-generator](https://github.co
### 1. Install the skill
-> Requires Claude Pro, Max, Team, or Enterprise plan (or Claude Code).
+Archify is packaged as an agent skill directory (`archify/SKILL.md`), so the same [`archify.zip`](archify.zip) works with Claude, Codex CLI, and opencode.
**Claude.ai:**
1. Download [`archify.zip`](archify.zip)
@@ -134,10 +134,31 @@ unzip archify.zip -d ~/.claude/skills/
unzip archify.zip -d ./.claude/skills/
```
-The typed renderers (workflow / sequence / dataflow / lifecycle) rely on ajv for schema validation, which takes a one-time `npm install` in the skill directory. Claude installs it automatically on first use, following the Setup instructions in `SKILL.md` — or run it yourself:
+**Codex CLI:**
+```bash
+# Global (all projects)
+unzip archify.zip -d ~/.agents/skills/
+
+# Or project-local
+unzip archify.zip -d ./.agents/skills/
+```
+
+**opencode:**
+```bash
+# Global (opencode-native)
+unzip archify.zip -d ~/.config/opencode/skills/
+
+# Or project-local
+unzip archify.zip -d ./.opencode/skills/
+
+# Also works: the shared agent directory used above for Codex
+unzip archify.zip -d ~/.agents/skills/
+```
+
+The typed renderers (workflow / sequence / dataflow / lifecycle) rely on ajv for schema validation, which takes a one-time `npm install` in the installed skill directory. Many agent runtimes can run it automatically on first use, following the Setup instructions in `SKILL.md` — or run it yourself:
```bash
-cd ~/.claude/skills/archify && npm install
+cd ~/.agents/skills/archify && npm install
```
Without the dependency the renderers skip schema validation (layout checks still run).
@@ -150,6 +171,8 @@ What each install surface can do:
| Install surface | Capability |
|---|---|
| **Claude Code** | Full — runs the typed renderers + schema validation |
+| **Codex CLI** | Full — install to `~/.agents/skills/` or `.agents/skills/` |
+| **opencode** | Full — install to `.opencode/skills/`, `.agents/skills/`, or another supported skills directory |
| **Claude.ai (zip upload)** | Usually full — depends on whether the sandbox can `npm install`, which it typically can |
| **Project Knowledge** | Architecture mode only — no code execution, purely prompt-driven |
diff --git a/README_ZH.md b/README_ZH.md
index 92b09b96..201c0709 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -4,7 +4,7 @@
**聊两句就画出好看的架构图、技术流程图、调用时序图、数据流图和生命周期图。深色 / 浅色一键切。导出最高 4× 清晰 PNG / JPEG / WebP / SVG,或直接复制到剪贴板。**
-Archify 是一个 [Claude Skill](https://support.claude.com/en/articles/12512180-using-skills-in-claude):你用大白话描述自己的系统或流程,它就把你的描述变成一张做工精细的技术图 —— 一个单文件 HTML,在浏览器里打开就能切主题、复制到剪贴板、导出成各种图片格式。
+Archify 是一个可用于 Claude、Codex CLI 和 opencode 的 agent skill:你用大白话描述自己的系统或流程,它就把你的描述变成一张做工精细的技术图 —— 一个单文件 HTML,在浏览器里打开就能切主题、复制到剪贴板、导出成各种图片格式。
- **不需要会画图** —— 把组件和连接关系说给 Claude 就行
- **支持 workflow / sequence / data flow / lifecycle** —— 技术流程、审批链、工具调用、CI/CD、请求调用链、数据管线、PII 边界、状态机都可以画
@@ -16,7 +16,7 @@ Archify 是一个 [Claude Skill](https://support.claude.com/en/articles/12512180
- **聊天迭代** —— "把 Redis 挪到左边"、"鉴权服务换成玫红"、"加个 Kafka"
![License](https://img.shields.io/badge/license-MIT-22c55e?style=flat-square)
-![Claude](https://img.shields.io/badge/Claude-Skill-7C3AED?style=flat-square)
+![Agent Skill](https://img.shields.io/badge/Agent-Skill-7C3AED?style=flat-square)
![Version](https://img.shields.io/badge/version-2.6.0-0891b2?style=flat-square)
**[在线落地页 → tt-a1i.github.io/archify](https://tt-a1i.github.io/archify/)**
@@ -119,7 +119,7 @@ Archify 基于 [Cocoon-AI/architecture-diagram-generator](https://github.com/Coc
### 1. 安装 skill
-> 需要 Claude Pro / Max / Team / Enterprise 套餐,或 Claude Code。
+Archify 打包成标准 agent skill 目录(`archify/SKILL.md`),同一个 [`archify.zip`](archify.zip) 可以用于 Claude、Codex CLI 和 opencode。
**Claude.ai:**
1. 下载 [`archify.zip`](archify.zip)
@@ -138,10 +138,31 @@ unzip archify.zip -d ~/.claude/skills/
unzip archify.zip -d ./.claude/skills/
```
-类型化渲染器(workflow / sequence / dataflow / lifecycle)依赖 ajv 做 schema 校验,需要在 skill 目录执行一次 `npm install`。首次使用时 Claude 会按 `SKILL.md` 的 Setup 指引自动安装;也可以自己先装好:
+**Codex CLI:**
+```bash
+# 全局(所有项目可用)
+unzip archify.zip -d ~/.agents/skills/
+
+# 或者仅当前项目
+unzip archify.zip -d ./.agents/skills/
+```
+
+**opencode:**
+```bash
+# 全局(opencode 原生目录)
+unzip archify.zip -d ~/.config/opencode/skills/
+
+# 或者仅当前项目
+unzip archify.zip -d ./.opencode/skills/
+
+# 也可以复用上面 Codex 的通用 agent 目录
+unzip archify.zip -d ~/.agents/skills/
+```
+
+类型化渲染器(workflow / sequence / dataflow / lifecycle)依赖 ajv 做 schema 校验,需要在安装后的 skill 目录执行一次 `npm install`。很多 agent runtime 首次使用时会按 `SKILL.md` 的 Setup 指引自动安装;也可以自己先装好:
```bash
-cd ~/.claude/skills/archify && npm install
+cd ~/.agents/skills/archify && npm install
```
没装依赖时渲染器会跳过 schema 校验(布局检查仍然运行)。
@@ -154,6 +175,8 @@ cd ~/.claude/skills/archify && npm install
| 安装方式 | 能力 |
|---|---|
| **Claude Code** | 完整 —— 可运行类型化渲染器 + schema 校验 |
+| **Codex CLI** | 完整 —— 安装到 `~/.agents/skills/` 或 `.agents/skills/` |
+| **opencode** | 完整 —— 安装到 `.opencode/skills/`、`.agents/skills/` 或其他支持的 skills 目录 |
| **Claude.ai 上传 zip** | 通常可用 —— 取决于沙箱能否 `npm install`,一般可以 |
| **Project Knowledge** | 仅架构模式 —— 不执行代码,纯 prompt 驱动 |
diff --git a/docs/index.html b/docs/index.html
index acdd706b..bec69ff5 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Archify — Architecture Diagrams from Plain English</title>
- <meta name="description" content="A Claude Skill that turns plain-English descriptions into polished, self-contained HTML architecture diagrams with dark/light themes, clipboard copy, and 4× export.">
+ <meta name="description" content="An agent skill for Claude, Codex CLI, and opencode that turns plain-English descriptions into polished, self-contained HTML architecture diagrams with dark/light themes, clipboard copy, and 4× export.">
<meta name="theme-color" content="#020617">
<link rel="icon" type="image/svg+xml" href="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 28 28'><polygon points='14,2 26,8 26,20 14,26 2,20 2,8' fill='%23083344' stroke='%2322d3ee' stroke-width='1.5'/><circle cx='14' cy='15' r='2.5' fill='%2322d3ee'/></svg>">
@@ -216,7 +216,7 @@
<div class="container">
<div class="hero-badge fade-up">
<div class="pulse-dot"></div>
- <span data-i18n="hero-badge">Claude Skill &nbsp;·&nbsp; v2.6.0</span>
+ <span data-i18n="hero-badge">Agent Skill &nbsp;·&nbsp; v2.6.0</span>
</div>
<h1 class="fade-up d1" data-i18n="hero-h1">From plain English<br>to architecture <em>in seconds.</em></h1>
<p class="hero-sub fade-up d2" data-i18n="hero-sub">Describe your system in chat. Archify generates a polished, self-contained HTML diagram — with dark/light themes, clipboard copy, and ultra-crisp 4× export built in.</p>
@@ -462,13 +462,13 @@
<div>
<div class="section-label fade-up" data-i18n="label-qs">Quick Start</div>
<h2 class="section-heading fade-up d1" data-i18n="qs-h2">Up and running<br>in three steps.</h2>
- <p class="section-body fade-up d2" style="margin-bottom:2.5rem" data-i18n="qs-body">Requires Claude Pro, Max, Team, or Enterprise — or Claude Code CLI.</p>
+ <p class="section-body fade-up d2" style="margin-bottom:2.5rem" data-i18n="qs-body">Works with Claude, Codex CLI, and opencode.</p>
<div class="steps">
<div class="step fade-up d1">
<div class="step-num">1</div>
<div class="step-content">
<h4 data-i18n="step1-h">Install the Skill</h4>
- <p data-i18n="step1-p">Download <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>, go to Claude Settings → Capabilities → Skills, click + Add and upload it. Or unzip to ~/.claude/skills/ for CLI use.</p>
+ <p data-i18n="step1-p">Download <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>. Upload it in Claude Settings, or unzip it for CLI agents: ~/.claude/skills/ for Claude Code, ~/.agents/skills/ for Codex, ~/.config/opencode/skills/ or .opencode/skills/ for opencode.</p>
</div>
</div>
<div class="step fade-up d2">
@@ -570,7 +570,7 @@ this description.</span>
const LANGS = {
en: {
'nav-docs':'Docs','nav-install':'Install Skill',
- 'hero-badge':'Claude Skill &nbsp;·&nbsp; v2.6.0',
+ 'hero-badge':'Agent Skill &nbsp;·&nbsp; v2.6.0',
'hero-h1':'From plain English<br>to architecture <em>in seconds.</em>',
'hero-sub':'Describe your system in chat. Archify generates a polished, self-contained HTML diagram — with dark/light themes, clipboard copy, and ultra-crisp 4× export built in.',
'hero-cta':'Get started','hero-gh':'View on GitHub',
@@ -615,8 +615,8 @@ this description.</span>
'chip-external':'External','chip-external-use':'Users, 3rd parties, generic',
'label-qs':'Quick Start',
'qs-h2':'Up and running<br>in three steps.',
- 'qs-body':'Requires Claude Pro, Max, Team, or Enterprise — or Claude Code CLI.',
- 'step1-h':'Install the Skill','step1-p':'Download <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>, go to Claude Settings → Capabilities → Skills, click + Add and upload it. Or unzip to ~/.claude/skills/ for CLI use.',
+ 'qs-body':'Works with Claude, Codex CLI, and opencode.',
+ 'step1-h':'Install the Skill','step1-p':'Download <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>. Upload it in Claude Settings, or unzip it for CLI agents: ~/.claude/skills/ for Claude Code, ~/.agents/skills/ for Codex, ~/.config/opencode/skills/ or .opencode/skills/ for opencode.',
'step2-h':'Describe your system','step2-p':'Write a plain-English description of your architecture — components, connections, cloud services. Or ask Claude to analyze your codebase first.',
'step3-h':'Ask Claude to draw it','step3-p':'Tell Claude to use the Archify skill. It generates a self-contained HTML file you open in any browser. Iterate from there — in plain English.',
'code-label':'example prompt',
@@ -626,7 +626,7 @@ this description.</span>
},
zh: {
'nav-docs':'文档','nav-install':'安装技能',
- 'hero-badge':'Claude 技能 &nbsp;·&nbsp; v2.6.0',
+ 'hero-badge':'Agent 技能 &nbsp;·&nbsp; v2.6.0',
'hero-h1':'用自然语言,<br>秒级生成<em>架构图。</em>',
'hero-sub':'在对话中描述你的系统,Archify 生成精美、独立的 HTML 架构图——内置深色/浅色主题、一键复制剪贴板、超清 4× 图片导出。',
'hero-cta':'快速开始','hero-gh':'在 GitHub 查看',
@@ -671,8 +671,8 @@ this description.</span>
'chip-external':'外部系统','chip-external-use':'用户、第三方、通用外部',
'label-qs':'快速开始',
'qs-h2':'三步上手,<br>即刻运行。',
- 'qs-body':'需要 Claude Pro、Max、Team 或 Enterprise 计划,或 Claude Code CLI。',
- 'step1-h':'安装技能','step1-p':'下载 <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>,进入 Claude 设置 → 能力 → 技能,点击「+ 添加」上传。或解压至 ~/.claude/skills/ 供 CLI 使用。',
+ 'qs-body':'支持 Claude、Codex CLI 和 opencode。',
+ 'step1-h':'安装技能','step1-p':'下载 <a href="https://github.com/tt-a1i/archify/raw/main/archify.zip">archify.zip</a>。Claude 可在设置里上传;CLI agent 可解压到对应目录:Claude Code 用 ~/.claude/skills/,Codex 用 ~/.agents/skills/,opencode 用 ~/.config/opencode/skills/ 或 .opencode/skills/。',
'step2-h':'描述你的系统','step2-p':'用自然语言描述你的架构——组件、连接关系、云服务。也可以先让 Claude 分析你的代码仓库。',
'step3-h':'让 Claude 绘制','step3-p':'告诉 Claude 使用 Archify 技能,它会生成独立的 HTML 文件,用任意浏览器打开即可。然后继续用自然语言迭代。',
'code-label':'示例提示词',