Internal Architecture

Explore how FreeCode's thin-client architecture enables scalable AI-assisted coding

Interactive Blueprint & Execution Engine

FreeCode operates as a persistent CLI daemon coordinating a stateful Agent Loop, pluggable Safety Hooks, a local Context Engine, and parallelized Sub-Agents. Select any card or node in the interactive blueprint below to explore deep architectural insights, links to source code files, and simulated execution logs!

INTERACTIVE SYSTEM BLUEPRINT
JSON-RPC Taskdelegate subtasksresultson startupread / write contextcallresult>_ FREECODE CLI BACKEND (DAEMON)YOU / CLIENTSTerminal TUIpi-tui renderingVSCode ExtReact webviewThin clientsโš™๏ธ AGENTReasoning Loop๐Ÿ’พ SUB-AGENTSSub-AgentTaskerSub-AgentTesterParallel execution๐Ÿ“„ CONTEXTAGENTS.mdSkillsProject conventionsMemoryauto-compactswhen fullHooks(Safety Middleware)๐Ÿ› ๏ธ TOOLSFile Read/Writeread.ts, write.ts>_Bash Shellbash.tsGrep Searchgrep.ts, find.tsGlob Matchglob.tsAction handler suite
๐Ÿ’ก Click on any system component above to inspect its architecture, source code files, and execution logs.

System Domain Boundaries

CLI (All Intelligence)
Browser Controller
Agent Loop
Parser
Tools
Context Engine
TUI & VSCode (Presentation)
Rendering
IPC Client
State Management
Providers (External)
ChatGPT
Claude
Gemini