How esengine/deepseek-reasonix works
Reasonix is a local coding-agent engine exposed through terminal, desktop, browser, and editor/ACP interfaces. The main workflow is a user request entering an interface, reaching the shared session controller, then running an agent turn that uses configured models and tools and streams events back. The README also documents planning, permissions, sandboxing, checkpoints, plugins, extensions, and context maintenance; these are represented as runtime branches. The tree and excerpts establish some subsystem boundaries but not all call wiring, so uncertain links are omitted.
Main entry points: boot Runtime assembly · agent Agent turn loop · controller.go Session controller · main.go CLI entry
Components 20
User interfaces
- CLI entry
cmd/reasonix/main.go - Studio UI
desktop/frontend-next/src/main.tsx - Browser UI
internal/frontend/serve - Editor ACP
cmd/reasonix/main.go - Storage controls
internal/frontend/serve/storage.go
Agent runtime
- Runtime assembly
internal/assembly/boot - Session controller
internal/session/control/controller.go - Agent turn loop
internal/runtime/agent - Model providers
internal/assembly/boot/provider_config.go - Planner models
internal/assembly/boot/side_models.go
Tools and integrations
- Agent tools
internal/assembly/boot - Workspace sandbox
internal/assembly/boot/isolation.go - Browser engine
internal/platform/browser/engine.go - MCP servers
internal/assembly/boot/mcp_registration.go - Extensions
internal/assembly/boot/extension_stage.go
Context and state
- Context maintenance
internal/runtime/agent/context_manager.go - Session state
internal/session/control/controller.go - Session temp
internal/state/sessiontemp/manager.go - Storage roots
internal/contract/config/storage_roots.go
Other components
- User
Connections 21
- User → CLI entry: requests
- User → Studio UI: requests
- User → Browser UI: requests
- User → Editor ACP: requests
- CLI entry → Runtime assembly: starts engine
- Studio UI → Runtime assembly: uses shared engine
- Browser UI → Runtime assembly: uses shared engine
- Editor ACP → Runtime assembly: uses shared engine
- Runtime assembly → Session controller: assembles
- Session controller → Agent turn loop: drives turns
- Agent turn loop → Model providers: samples model
- Agent turn loop → Planner models: uses optionally
- Agent turn loop → Agent tools: invokes
- Agent tools → Workspace sandbox: executes within
- Agent tools → Browser engine: uses optionally
- Runtime assembly → MCP servers: registers
- Runtime assembly → Extensions: loads
- Agent turn loop → Context maintenance: prepares context
- Session controller → Session state: manages lifecycle
- Session controller → Session temp: shares session temp
- Storage controls → Storage roots: surveys and plans moves