How styler-ai/projectatlas works
ProjectAtlas is a local repository-intelligence CLI and MCP server. Its main workflow binds an agent to a project, refreshes or queries the project atlas, then returns focused navigation and evidence—summaries, symbols, relationships, health, or source slices. The README documents these product stages; sampled source most clearly establishes the CLI/MCP entry points, symbol extraction, and optional-parser runtime. Some subsystem links below reflect documented behavior and module boundaries rather than inspected call sites.
Main entry points: runtime.rs Runtime orchestration · mcp.rs MCP server · main.rs CLI commands · index_work.rs Index work
Components 22
Agent interfaces
- CLI commands
crates/projectatlas-cli/src/main.rs - MCP server
crates/projectatlas-cli/src/mcp.rs
Indexing and analysis
- Runtime orchestration
crates/projectatlas-cli/src/runtime.rs - Index work
crates/projectatlas-core/src/index_work.rs - Worktree access
crates/projectatlas-fs/src/worktree.rs - Symbol extraction
crates/projectatlas-symbols/src/lib.rs
Project state
- Atlas database
crates/projectatlas-db/src/lib.rs - Repository graph
crates/projectatlas-db/src/repository_graph.rs - Project identity
crates/projectatlas-db/src/project_identity.rs
Navigation and insight
- Analysis services
crates/projectatlas-service/src/analysis.rs - Relation services
crates/projectatlas-service/src/relations.rs - Graph model
crates/projectatlas-core/src/graph.rs - Health findings
crates/projectatlas-core/src/health.rs - Compact output
crates/projectatlas-core/src/toon.rs - Token dashboard
crates/projectatlas-cli/src/token_tui.rs
Optional parsing
- Parser coordinator
crates/projectatlas-cli/src/runtime/optional_parser_runtime.rs - Worker supervisor
crates/projectatlas-cli/src/parser_supervisor.rs - Parser worker
crates/projectatlas-cli/src/parser_worker.rs - Worker protocol
crates/projectatlas-core/src/optional_parser_protocol.rs
Other components
- Coding agent
- CLI user
- MCP host
Connections 22
- CLI user → CLI commands: runs commands
- Coding agent → MCP host: requests tools
- MCP host → MCP server: dispatches tools
- CLI commands → Runtime orchestration: invokes operations
- MCP server → Runtime orchestration: routes requests
- Runtime orchestration → Index work: coordinates indexing
- Index work → Worktree access: scans worktree
- Index work → Symbol extraction: extracts symbols
- Runtime orchestration → Atlas database: reads and writes
- Symbol extraction → Graph model: produces graph
- Runtime orchestration → Repository graph: persists graph
- Runtime orchestration → Project identity: binds project
- MCP server → Analysis services: serves insight tools
- Analysis services → Relation services: resolves relations
- Analysis services → Health findings: reports health
- MCP server → Compact output: formats responses
- CLI commands → Token dashboard: opens dashboard
- Token dashboard → Repository graph: reads map data
- Runtime orchestration → Parser coordinator: parses optional jobs
- Parser coordinator → Worker supervisor: supervises worker
- Worker supervisor → Parser worker: sends requests
- Parser worker → Worker protocol: exchanges messages