07 Local Runtime

07 Local Runtime

Source: docs/design/07-local-runtime.md

Positioning

KepCup is a local client application. Cloud pieces (supplier, OAuth helpers, remote relay) are optional overlays — not required for core chat/execute.

Process structure

Electron main + renderer; core as a separate Node process hosting services and agent loops. Port B host capabilities (browser, sensors, notifications) live in desktop layers.

Environment configuration

Two layers:

• Host — runtimes the app manages (Node tools, MinerU install, WSL, etc.), installed on Bot request with user confirm each time (D13)
• Workspace — project-local deps inside the user’s workdir

Health checks and graceful degradation when sandbox or optional tools are missing (13-Permissions per-command confirm mode).