Equip your AI coding agent to read real source code and build interactive, 100% offline 3D Spatial & 2D Bento architecture maps.
English · 简体中文 · Website · Live 3D Sandbox · Guides · Compare Tools
Captured live from archray.dev/demo: interactive 3D Spatial Atrium, 2D Bento map, Health Hotspots, and Replaceability views—click to explore live.
LLMs excel at reading repository structure and control flow—but collapse into crossed edges when hand-authoring SVG coordinates or raw diagrams. ArchRay decouples semantic extraction from layout math:
Analyze source once into .archray/graph.json, then switch projections, health diagnostics, and shareable exports with zero extra LLM calls:
Requirements: Node.js 20+,
curl, andtar(on Windows, run the installer inside Git Bash or WSL; it emits.archray\archray.cmd).
curl -fsSL https://github.com/loofare/ArchRay/releases/latest/download/install.sh | sh -s -- . claudeReplace claude with your AI host (comma-separated lists like claude,cursor or all are supported):
| AI Host | Argument | Session Trigger | Host Files Written |
|---|---|---|---|
claude |
/archray, /archray:frontend, … |
.claude/skills/archray/, .claude/commands/ |
|
cursor |
/archray, /archray-frontend, … |
.cursor/rules/archray.mdc, .cursor/commands/ |
|
antigravity |
/archray or Skill trigger |
.agent/skills/archray/, .agent/commands/ |
|
pi |
/archray, /archray-frontend, /skill:archray |
.agents/skills/archray/, .pi/prompts/ |
|
codex |
$archray or /skills |
.agents/skills/archray/SKILL.md |
Prefer letting your AI coding assistant run setup? Paste this prompt
Download https://github.com/loofare/ArchRay/releases/latest/download/install.sh to a temporary file, verify it succeeded, and run `sh <temp-file> . claude` from this repo root (replace claude with your host).
- Open a fresh AI coding session in the repository.
- Run
/archray($archrayon Codex), or simply ask: “Use archray to inspect source code and build a 3D map”. - Open
.archray/index.htmldirectly in any browser.
Once .archray/graph.json is generated, slice any single layer or comma-separated cross-layer path on demand—direct one-hop neighbors remain softly dimmed for context:
| Goal | Slash Command / Args | What It Focuses |
|---|---|---|
| View All (Default) | /archray or /archray:full |
All 10 architectural layers (L0–L9) |
| Frontend | /archray:frontend or /archray frontend |
L0 client web apps, mobile & UI surfaces |
| Backend + Async | /archray:backend or /archray backend |
L3 service domain APIs + L4 async queues/workers |
| Data & Storage | /archray:data or /archray data |
L5 data SQL databases, Redis caches, search & S3 |
| Network & Edge | /archray:network or /archray network |
L1 edge + L2 gateway CDN, WAF & ingress |
| Security & Auth | /archray:security or /archray security |
L2 gateway OAuth/OIDC, JWT guards & rate limits |
| Cross-Layer Combos | /archray frontend,backend/archray backend,data/archray ai,async,data |
Combine any layers with commas (EN & ZH aliases work) |
| Theme & Locale | --style blueprint --lang en |
Themes: tech / blueprint / glass / paper |
| Update / Uninstall | /archray update / /archray uninstall |
Safely keeps graph.json, view.json, and HTML |
Tested on real engineering repositories—confirming non-overlapping ELK layouts, +N auto-collapsing on dense monorepos, and v0.6.0 UTF-8 without BOM enforcement:
| Benchmark Repository | Scale & Topology | Build / Layout Speed | Verified Highlights |
|---|---|---|---|
calcom/cal.com (ae027bb) |
7,712 tracked files → 33 modules · 75 edges · 7 layers |
196ms Node ELK layout |
Dense packages fold (+N), 60fps 3D orbit |
| FreshMart Commerce (Live Demo) | 16 modules · 19 edges · 5 layers · Checkout flow |
Instant single-file HTML | Surfaces 6.2k LOC lock hotspot & Clerk migration plan |
| SaaS Starter & RealWorld | 43–49 source files |
0.03s CLI build |
Maps App Router/Prisma/Stripe, flags JWT_SECRET fallback |
- Comparing ArchRay against Mermaid, Structurizr DSL, Eraser, or Excalidraw? See the full matrix: ArchRay vs Mermaid, Structurizr & Eraser.
- Playbooks & specs: Claude Code Guide · Cursor Guide · Codex, Pi & Antigravity · Layers & CLI Reference.
Self-contained wrapper inside .archray/ with zero global pollution (.archray\archray.cmd on Windows):
./.archray/archray doctor # Check packaged assets & Node version
./.archray/archray validate .archray/graph.json # Validate TypeBox schema, locales & UTF-8
./.archray/archray build .archray/graph.json --force --no-open # Rebuild single-file offline HTML
./.archray/archray build .archray/graph.json --layers frontend,data --style blueprint --forceUpgrade & Uninstall:
./.archray/archray update --check # Check latest release without modifying files
./.archray/archray update # Verify SHA-256 & update (keeps graph/view/HTML)
./.archray/archray uninstall --dry-run # Preview files to be removed
./.archray/archray uninstall # Remove tool & host commands (keeps graph/view/HTML)
./.archray/archray uninstall --purge # Remove the entire .archray/ directoryOne-time upgrade from v0.4.0 or earlier
curl -fsSL https://github.com/loofare/ArchRay/releases/latest/download/install.sh | sh -s -- . auto --forceNote
100% Local · Zero Source Upload · Verifiable Provenance
- ArchRay CLI and generated
.archray/index.htmlviews run completely offline overfile://; source code, paths, and graphs never leave your machine (analysis happens solely inside your authorized coding-agent session). - Not a SaaS scanner or live APM agent;
sourcePaths, health findings, and replacement candidates are static review claims to verify against code. - Only an explicit
updatecontacts GitHub Releases read-only to checklatest.jsonand verify SHA-256 archives.
See Host Compatibility · Changelog · NOTICE · MIT License · archray.dev.