Documentation
Architecture
Felix employs a decoupled architecture designed for visibility and control. The system is split into three distinct layers with file-based boundaries:
visibility
Frontend (Observer)
Provides real-time visibility into plans, artifacts, and execution history without requiring direct access to the source code.
settings_input_component
Backend (Orchestrator)
Enforces mode boundaries (Planning vs Building), coordinates run state, and handles optional synchronization.
terminal
Agent (Executor)
Independent processes that execute tasks in isolated environments. Communication is handled via filesystem artifacts.
Last updated: 2026-11-01