CodeArchy

Offline-first privacy VS Code extension that visualizes your codebase as a high-level architecture diagram.

CodeArchy is an open-source offline-first privacy AI system that parse codebase into explainable system architecture for education, onboarding, and safer software development/maintenance.

Features

• Multi-Language Parsing — TypeScript, JavaScript, Python, Java, Go, Rust
• Dependency Graph — Automatic import/dependency detection and resolution
• Architecture Inference — Heuristic grouping of modules into semantic subsystems (API, Services, Models, Auth, etc.)
• Interactive Visualization — Pan, zoom, drag nodes, click to inspect, double-click to open files
• Incremental Updates — Re-analyzes only changed files on save
• Activity Bar — Browse modules and subsystems in a dedicated tree view
• Offline-First — Zero network calls at runtime

Quick Start

1. Open a project in VS Code
2. Run CodeArchy: Show Architecture from the Command Palette (Cmd+Shift+P)
3. Explore the interactive dependency graph

Commands

Configuration

Architecture

VS Code Events
     ↓
Incremental Parser (multi-language AST)
     ↓
Symbol & Dependency Extractor
     ↓
Graph Builder (nodes + edges)
     ↓
Architecture Inference Layer (heuristic grouping)
     ↓
Interactive Webview Visualization

Development

# Install dependencies
npm install

# Compile
npm run compile

# Watch mode
npm run watch

# Lint
npm run lint

# Press F5 in VS Code to launch in dev mode

See CONTRIBUTING.md for full development guidelines.

Roadmap

• [X] Tree-sitter WASM integration for full AST fidelity
• [X] React Flow rendering engine
• [X] Cytoscape.js optional dense-graph view
• [X] Export architecture diagrams (SVG, PNG)
• [ ] Gemma 4 local AI inference for semantic subsystem naming
• [ ] Multi-root workspace support
• [ ] Custom subsystem rules

License

MIT