----------------
🛠️ Tool
===================
Archify is an agent skill that converts a codebase or system description into an interactive, shareable technical map, directly within chat-based development agents.
🔹 Tool Purpose and Capabilities
Archify integrates with Raven, Cursor, Claude Code, Codex CLI, and OpenCode. You provide a system description or point it at a repository, and it generates a polished, interactive system map. The current development version is v2.16.0-dev.0.
🔹 Key Features
• Five diagram types with four presets, dark/light themes, built-in brand marks, and finite motion
• Before / Delta / After snapshot comparison: shows exactly what was added, removed, changed, moved, and rerouted between two validated states
• Grounded interactions: search nodes, optionally open revision-verified source, trace upstream/downstream authored reach and exact routes, compare roles, and play guided stories without inventing topology
• Single-file output: typed JSON IR and deterministic checks produce self-contained HTML plus PNG, SVG, WebM, and 1200x630 share cards
🔹 Technical Implementation
The tool relies on a typed JSON IR (intermediate representation) as its ground truth. Deterministic checks run against this IR to ensure the generated visual artifacts stay consistent with the underlying facts. The IR approach means the map does not hallucinate topology; it only renders what the IR encodes.
🔹 Use Cases
• Reviewing architecture changes before merge by comparing validated snapshots
• Presenting system architecture to stakeholders via shareable HTML artifacts
• Tracing dependency reach and routing within a codebase during onboarding or audits
• Generating share cards for documentation or social posts
🔹 Installation
npx skills add tt-a1i/archify -g
For Cursor users, there is an agent-aware quick start guide on the project page.
🔹 Limitations
This is a development version (v2.16.0-dev.0). The source does not provide independent verification of output accuracy across complex or polyglot codebases. Haven't tested personally. License is MIT.
🔹 References
Project page: tt-a1i.github.io/archify
Scenario guide and Proof Lab available on the project site.
🔹 archify #agent_skills #system_map #codebase_visualization #tool
🔗 Source: https://github.com/tt-a1i/archify