How sebastian-abraham/syscode works
SysCode builds and maintains a grounded, persistent design map of a developer’s project, then presents it as an explorable canvas and uses it to answer questions or propose map changes. The primary flow is project scan → code facts → map/reconciliation → local persistence → HTTP API → interface; chat adds scoped context and optional model-backed responses. The README documents additional capabilities whose internal wiring is not shown in the excerpts. Edges are limited to those supported by excerpts, the SOURCE INDEX, or explicit README statements.
Main entry points: service.ts Map service · index.ts Fact assembly · store.tsx Web state and API · http.ts Local HTTP API
Components 22
Code analysis
- Repository scan
packages/core/src/analyze/scan.ts - TS/JS analysis
packages/core/src/analyze/tsjs.ts - Python analysis
packages/core/src/analyze/py.ts - External services
packages/core/src/analyze/external.ts - Fact assembly
packages/core/src/analyze/index.ts
Map and memory
- Heuristic mapper
packages/core/src/map/heuristic.ts - Identity and reconcile
packages/core/src/map/identity.ts - Map service
packages/core/src/map/service.ts - Scoped context
packages/core/src/memory/context.ts - Project map store
packages/core/src/store/db.ts
Agent and API
- Agent
packages/core/src/llm/agent.ts - Model provider
packages/core/src/llm/provider.ts - Local HTTP API
packages/core/src/server/http.ts
Developer interface
- Web state and API
apps/web/src/store.tsx - Map canvas
apps/web/src/components/Canvas.tsx - Inspector and context
apps/web/src/components/Inspector.tsx - Chat and proposals
apps/web/src/components/ChatPanel.tsx - Interface icons
apps/web/src/components/icons.tsx
Desktop shell
- Desktop shell
apps/desktop/src-tauri/src/main.rs
Other components
- Developer
- Project source
- LLM service
Connections 29
- Developer → Project source: maps project
README.md - Project source → Repository scan: scans files
- Repository scan → Fact assembly: returns scanned files
packages/core/src/analyze/index.ts - Fact assembly → TS/JS analysis: parses TS/JS
packages/core/src/analyze/index.ts - Fact assembly → Python analysis: parses Python
packages/core/src/analyze/index.ts - Fact assembly → External services: classifies imports
packages/core/src/analyze/index.ts - Fact assembly → Map service: supplies facts
packages/core/src/map/service.ts - Map service → Heuristic mapper: builds map
packages/core/src/map/service.ts - Map service → Identity and reconcile: reconciles identity
packages/core/src/map/service.ts - Map service → Project map store: reads and writes
packages/core/src/map/service.ts - Map service → Scoped context: builds context
packages/core/src/map/service.ts - Scoped context → Project map store: reads map data
packages/core/src/memory/context.ts - Scoped context → Project source: reads anchored code
packages/core/src/memory/context.ts - Local HTTP API → Map service: routes map operations
packages/core/src/server/http.ts - Local HTTP API → Agent: routes chat
packages/core/src/server/http.ts - Local HTTP API → Model provider: probes model
packages/core/src/server/http.ts - Agent → Scoped context: uses scoped context
packages/core/src/llm/agent.ts - Agent → Model provider: requests model response
packages/core/src/llm/agent.ts - Model provider → LLM service: calls configured model
- Developer → Web state and API: uses interface
README.md - Web state and API → Local HTTP API: calls engine API
README.md - Web state and API → Map canvas: supplies map state
apps/web/src/components/Canvas.tsx - Web state and API → Inspector and context: supplies selection
apps/web/src/App.tsx - Web state and API → Chat and proposals: streams chat
apps/web/src/store.tsx - Map canvas → Interface icons: renders icons
apps/web/src/components/Canvas.tsx - Inspector and context → Scoped context: shows agent context
README.md - Chat and proposals → Agent: sends questions
README.md - Developer → Desktop shell: launches desktop
README.md - Desktop shell → Local HTTP API: connects to engine
README.md