One click to understand what you built. Local-first, privacy-focused.
English | 繁體中文
Screenshots coming soon
You built an app, but you're not sure how all the pieces fit together. CodeAtlas turns any codebase into interactive visual maps so you can understand your project's architecture, data flow, and logic — without reading a single line of code.
- Visual understanding — See your entire project as interactive maps, not walls of code
- AI-powered explanations — Get plain-language summaries of what each part does (Claude, Gemini, OpenAI, Ollama, or fully offline)
- Three perspectives — Structure Flow (file connections), Logic Overview (what each part does), Data Journey (how data moves)
- Wiki knowledge export — Generate readable documentation + Obsidian-compatible knowledge graph
- Local-first & private — Your code never leaves your machine, no cloud accounts needed
- Bilingual — English + Traditional Chinese (繁體中文)
- Multi-language — Supports JavaScript, TypeScript, Python, and Java projects
npx code-atlasThat's it. Your browser opens automatically — pick a project folder and start exploring.
npm install -g code-atlas
code-atlas| Command | Description |
|---|---|
code-atlas |
Zero-arg launch — opens browser, pick a project |
codeatlas web [path] |
Analyze a specific path and open the web UI |
code-atlas wiki [path] |
Export a knowledge wiki (Markdown for Obsidian) |
codeatlas analyze [path] |
CLI-only analysis (no browser) |
| Flag | Description |
|---|---|
--lang en|zh-TW |
Set UI and output language (default: en) |
--ai anthropic|gemini|openai|ollama|disabled |
Choose AI provider |
--port N |
Server port (default: 3000) |
Directory-level architecture view. See how modules are organized and which folders contain which roles — routes, services, models, middleware. Designed for getting oriented in an unfamiliar project quickly.
Method-level call flow. See how functions call each other, grouped by category (Routes, Middleware, Services, Data Access, Utilities). AI analyzes each method's role and purpose so you understand not just what calls what, but why.
Endpoint-level data flow. Trace a request from its API entry point through middleware, business logic, and data access — step by step, in sequence. Ideal for debugging or onboarding onto an API-heavy codebase.
CodeAtlas supports multiple AI providers for intelligent code analysis:
- Claude (Anthropic) — Recommended
- Gemini (Google)
- OpenAI (GPT)
- Ollama — Runs locally, no API key needed, fully private
- Disabled — Works without AI; you just won't get smart summaries
Configure your provider in the web UI Settings panel or via the --ai CLI flag. Cloud AI providers will transmit code snippets to their respective APIs — this is clearly indicated in the UI. If privacy is critical, use Ollama or disable AI entirely.
Generate Obsidian-compatible Markdown files from your codebase:
code-atlas wiki ./my-project --lang enProduces interlinked .md files with frontmatter, cross-references, and an interactive knowledge graph viewable in the web UI. Import the output folder directly into Obsidian to explore your codebase as a knowledge base.
| Layer | Technology |
|---|---|
| Language | TypeScript (full stack) |
| Frontend | React + React Flow + D3.js |
| Local server | Fastify |
| Code parsing | tree-sitter |
| Monorepo | pnpm workspace |
- Node.js >= 18
- pnpm >= 9 (for development only)
See CONTRIBUTING.md for development setup and contribution guidelines.
MIT — Copyright 2026 Stanshy