How sannongwangluo/tatai works
Tatai is a local-first desktop workbench for coordinating AI coding agents around shared project intent, plans, task progress, and verifiable evidence. A user works through the desktop UI or an agent through the stdio MCP server; both access project data, while migrated work-state writes go through one service into an event ledger. The product also provides architecture views, design/chat assistance, project monitoring, and backup/restore. README documents several capabilities whose implementation was not sampled; their wiring is shown only where documented, and the graph omits uncertain internal links.
Main entry points: index.ts Local HTTP server · App.tsx Tatai desktop UI · service.ts Work service · server.ts MCP server
Components 24
User Interfaces
- Tatai desktop UI
src/ui/App.tsx - Tauri shell
src-tauri/src/main.rs - Local HTTP server
src/server/index.ts - Design and plan UI
src/ui/components/DesignView.tsx - Project chat UI
src/ui/components/ChatView.tsx
Agent Coordination
- MCP server
src/mcp/server.ts - MCP tools
src/mcp/tools/index.ts
Project Work Ledger
- Work service
src/server/work/service.ts - Event ledger
src/server/work/eventStore.ts - Task state
src/server/work/tasks.ts - Work domains
src/server/work
Architecture Views
- Static architecture parser
src/arch/parse.ts - Architecture model
src/arch/blueprint.ts - Architecture views
src/ui/arch/ProjectGraphView.tsx
Project Services
- Project files
src/server/workstation.ts - Project registry
src/server/registry.ts - Chat and tools
src/server/chat.ts - Reverse design drafts
src/server/reverseDraft.ts - Live monitoring
src/server/live.ts - Backup and restore
src/server/work/backup.ts
Other components
- Project user
- Coding agent
- Configured model service
- Local project filesystem
Connections 31
- Project user → Tatai desktop UI: uses
- Tatai desktop UI → Local HTTP server: calls API
- Tauri shell → Tatai desktop UI: hosts UI
- Tauri shell → Local HTTP server: starts service
- Coding agent → MCP server: calls tools
- MCP server → MCP tools: dispatches
- MCP tools → Work service: submits writes
- Local HTTP server → Work service: submits writes
- Work service → Event ledger: appends events
- Work service → Event ledger: projects state
- Task state → Event ledger: reads events
- Local HTTP server → Project registry: reads projects
- MCP server → Project registry: resolves data
- Local HTTP server → Work domains: serves work APIs
- MCP tools → Work domains: reads work data
- Tatai desktop UI → Architecture views: shows graphs
- Local HTTP server → Static architecture parser: starts parsing
- Static architecture parser → Architecture model: builds graph
- Architecture views → Local HTTP server: reads graph data
- Tatai desktop UI → Design and plan UI: shows design
- Tatai desktop UI → Project chat UI: shows chat
- Project chat UI → Local HTTP server: sends turns
- Local HTTP server → Chat and tools: handles turns
- Chat and tools → Configured model service: requests completion
- Local HTTP server → Reverse design drafts: requests draft
- Reverse design drafts → Configured model service: requests draft
- Local HTTP server → Live monitoring: serves live state
- Local HTTP server → Backup and restore: handles backup
- Backup and restore → Local project filesystem: backs up privately
- Work domains → Project files: reads project data
- Project files → Local project filesystem: reads and writes