engineering / skill

Archify

Turn an idea, a plan or a codebase into an interactive diagram that you can explore and share as one HTML file.

At a glance

Purpose
Turn an idea, a plan or a codebase into an interactive diagram that you can explore and share as one HTML file.
Runs in
Chat app with skills, Local agent with shell, Web service
Operating systems
Not stated
Needs
Runtime: Node.js; Needs internet: Not stated; Needs accounts or API keys beyond your agent: Not stated
Files and data
Reads files: Yes; Writes files: Yes; Sends data to other services: Yes
Tool type
Skill
Delivery
From GitHub
Version
Latest on the main branch
Access
Code on GitHub
Compatibility
According to the README, it works with Cursor, Claude Code, Codex CLI and OpenCode, and it lists Claude.ai (zip upload), Project Knowledge, Hermes Agent and DeepSeek Harness as further surfaces. The README calls the Hermes Agent and DeepSeek Harness routes community integrations and says they are not official products of those vendors.
External costs
The repository is MIT-licensed. According to the README, Archify is free and open source, and third-party online services and paid plans are run by their providers and do not represent Archify. Your coding agent or model provider may charge for usage.
Permissions
The skill acts through your coding agent with the access you give it. According to the README, the install command uses the -g flag, and its installation table lists user-level skill folders such as ~/.claude/skills/ and ~/.agents/skills/ as well as project folders. The agent writes a JSON source and an HTML file. The command-line tool can run a loopback-only preview on a random local port that watches one JSON file, and the deliver command with the open option launches the finished file. Source-backed diagrams open files and line ranges pinned to one public commit, only when requested. Archify may send a request to fetch a release manifest for an optional update reminder, and the README says it never downloads or installs updates.
Usage terms
MIT License, as stated in the repository. See its LICENSE file for the exact terms.

Code on GitHub

tt-a1i/archify

MIT

JavaScript82,577 stars5,570 forksLast pushed 12 Oct 2026 UTC

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

Topics: agent-skills ai-agents architecture-diagram claude-code claude-skills codex coding-agents deepseek-harness

Public GitHub data fetched · 0 days old

Skill folders in this repository (2)

Folders that contain a SKILL.md file, from GitHub's file list on .

View on GitHub ↗

What it does

Archify is an agent skill that turns a description, a plan or a codebase into an interactive diagram. According to the README, you describe what you want to your AI agent, and Archify produces a self-contained HTML file that you can explore, customize and share.

The README names five diagram types: architecture, workflow, sequence, data flow and lifecycle. It says the agent generates a typed JSON source, bundled validators check that source, and a passing diagram is delivered as HTML. The README describes viewer controls for focusing a node, tracing upstream and downstream paths and exporting images and share cards, plus a command-line tool for validating, previewing and delivering diagrams.

No repository is required. The README says you can start from a description, or ask your agent to read a repository and build a source-backed architecture diagram.

Who it is for

Developers and others who want an AI agent to draw architecture, workflow or planning diagrams as interactive pages.

Example tasks

Draw a web request flow where a browser calls an API, the API checks Redis and a cache miss queries PostgreSQL.
Analyze a repository and create a high-level runtime architecture diagram.
Add authentication to an existing diagram, or highlight the cache-miss path.
Switch a diagram to the light theme.
Compare two architecture snapshots into a before and after delta page for design or pull request review.

Getting started

According to the README, run npx skills add tt-a1i/archify -g, then tell your agent what to draw, for example Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback. The README also gives an explicit Cursor install, npx skills use tt-a1i/archify@archify --agent codex to try it without installing, and upload steps for Claude.ai. The README has the exact commands.

Limitations

According to the README, Archify works with Cursor, Claude Code, Codex CLI and OpenCode. For Claude.ai it says the result depends on Node.js access in the sandbox, and uploading to Project Knowledge gives a prompt-driven fallback. The README runs its command-line tool with node, and names Node requirements for the optional Hermes Agent and DeepSeek Harness integrations. It says automatic Mermaid parsing, general-purpose auto-layout, hosted sharing and WYSIWYG editing are outside the current scope. The repository can change at any time; check its README before you install.

Data practices

According to the README, the output is a self-contained HTML file, and external websites and map links in a diagram need a network connection. Archify may fetch a fixed stable manifest solely to show an optional update reminder. The README says the server sees normal HTTP metadata (IP address and time) but receives no version, agent, project data, prompts, account or device ID, or ETag. Setting ARCHIFY_UPDATE_CHECK_DISABLED=1 disables networking and reminder-state writes. The README says the Hermes Agent and DeepSeek Harness integrations have no telemetry. What your coding agent and model provider receive depends on them.

Community experience

Not rated yet

Sign in to share your experience.

Comments 0

No comments yet.

Sign in to comment

Report a listing concern