09 Tech Stack

09 Tech Stack

Source: docs/design/09-tech-stack.md

Overview

Layer	Choice
Agent loop	pi (library, version-locked, behind KepCup interfaces)
Desktop	Electron; core = separate Node process
UI	Svelte 5 + shadcn-svelte
DB	better-sqlite3-multiple-ciphers + FTS5 + sqlite-vec

Why pi (D21 / D64)

Fits tool-calling agent loops; host wraps APIs so upgrades stay controlled (locked on 1.x). Host still implements: dual-loop orchestration, gateway approvals, context assembly, settlement, harness (43-Task-Loop-Harness).

External agents (D72)

Second AgentEngine implementation over ACP — not implemented. When present, used as task engine only; reply turns stay built-in. See 28-External-Agents-ACP.

Electron tradeoffs

Mature desktop APIs (share extension, keychain, browser); heavier than pure web. Renderer never talks to DB directly — only via core RPC.