POPUP-MCP ARCHITECTURE // ROUND-TRIP IPC PIPELINE
Out-of-process CLI agent asking graphical Electron host for decision
⏮ Reset
▶ Auto Play
Next Step ➔
STDIO
BINARY
SOCKET
IPC
USER
1. AGENT CLI
Process CLI
> prompt()
[waiting...]
2. TOOL CALL
JSON-RPC Packet
{ "mcp": 1.0,
"ask": "UI" }
3. POPUP-MCP
Relay Node Server
socket
4. IPC BRIDGE
Electron Main
MAIN
5. DIALOG UI
GUI Renderer
Input response...
NO
YES
6. USER CHOICE
Human Input
src/worker/acp.ts
CLI Agent execution process
Step 0: Initial state. The Agent CLI process is running and requires user input/approval.
STAGE 0 / 10