CodeAtlas

A local-first developer tool for repository mapping and code navigation.

Structure

codeatlas/
├── apps/
│   ├── cli/          # Command-line interface
│   ├── server/       # Fastify HTTP server
│   └── web/          # React + Vite web UI
├── packages/
│   └── core/         # Shared business logic, database, types
└── ...

Quick Start

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Start the server and open browser
pnpm dev
# or
projectmap-ai open .

Commands

# Open CodeAtlas for current repository
projectmap-ai open .

# Start server only
projectmap-ai start

# Custom port
projectmap-ai open . --port 4000

# Don't open browser
projectmap-ai open . --no-browser

Development

# Run tests
pnpm test

# Type check
pnpm typecheck

# Clean build artifacts
pnpm clean

Architecture

• apps/cli: Command entry, starts local server, opens browser
• apps/server: Fastify server, routes, WebSocket, request handlers
• apps/web: React + Vite UI for project map visualization
• packages/core: Shared logic, SQLite database, scanner, indexer, search, types

Default Port

Default server port is 3958.