π
[Core] Remote Approval Cockpit
One-tap command approval for Claude Code, Cline, and Cursor. Keeps autonomous development sprinting while grabbing coffee.
Interactive Blueprint Β· Official English Edition
Neo-Secretary: Desk Pet & AI Approval Cockpit Showcase
Trace how mobile one-tap approvals and autonomous AI completions flow through Zero-Trust authentication, LangGraph state machines, and SQLite WAL into rich multi-modal reactions.
Product Vision Β· PO Layer
π― North Star (Product Purpose & Why)
"Never let autonomous AI coding halt when you step away." Upcycle spare smartphones into a desk approval cockpit & living companion to maximize developer focus.
Core Value Proposition
π 3-Tier Product Architecture (The Core Triad)
πΎ
[Soul] 16-Bit Pixel Pet & Custom Mods
Breathing pixel companions share the joy of solved builds. Drop PNG sprites in a folder to load your favorite mascots.
π
[Base] Notebook, Habits & iCal Sync
The ergonomic bedrock that keeps the cockpit standing on your desk. Quietly tracks timeline tasks without bloated subscriptions.
Truth Ladder
Simple at First Sight, Honest to the Smallest Detail.
A palm-sized desktop companion that guards your focus, celebrates build milestones, and lets you approve commands from your couch.
A local-first architecture combining Tkinter desktop overlays with mobile PWA clients via Zero-Trust Bearer authentication, SQLite WAL, and asyncio event loops.
Peer sync operates strictly over local Wi-Fi or encrypted Tailscale mesh tunnels with zero third-party cloud relay and zero telemetry leakage.
Module Architecture
Module Blueprint Specification
Entrypoint
pwa-client
Outputs & Feedback
pc-mascot-ui
audio-feedback
Source Code
local-server-srcmain-app-srcdatabase-srcSignal Trace
Trace Real-Time Data Flow Across System Boundaries
Trace Ready (Click Play to Start)
1. Mobile PWA Ingress & Zero-Trust Authentication
The local Python server validates Bearer tokens and dispatches action requests sent from the mobile PWA client.
Mobile Desk Pet (PWA)
Always-on tactile smart display with 8-bit sound synthesis and offline caching.
Sync Server (LocalSyncServer)
Lightweight HTTP daemon enforcing constant-time Bearer authentication and CORS origin echoing.
- Impact
- Remote operations from smartphone are blocked.
- Symptom
- Server logs HTTP 401 Unauthorized errors.
- Fallback
- Re-issue pairing token instantly via desktop QR code.
2. LangGraph State Machine & Agent Supervision
Processes user commands and intercepts external AI agent build completions asynchronously without blocking UI render threads.
Agent Supervision Daemon
Monitors CLI build output and intercepts command approval requests in real time.
LangGraph & LLM Factory
Dynamically switches between Gemini, Claude, and local GGUF models.
- Impact
- Cloud AI reasoning is temporarily suspended.
- Symptom
- External API timeout or rate limit exceeded.
- Fallback
- Gracefully falls back to local GGUF models or preset dialogue lines.
3. Local Persistence & Multi-Modal Feedback
Persists state mutations into SQLite WAL and orchestrates desktop overlay animations and synthesized audio chimes.
SQLite WAL Database
Persistent store for tasks, habits, and tamper-resistant approval audit trails.
Desktop Mascot (Tkinter)
Top-level transparent window rendering breathing pixel sprites and comic balloons.
Audio & Chime Synthesizer
8-bit sound effects and speech synthesis for milestone notifications.
System Architecture Β· Archify Edition
ποΈ High-Definition System Architecture Blueprint
Interactive high-resolution architecture blueprint. Drag to pan and scroll to zoom.
π‘ Core Component Deep Dives (Tap to inspect details):
Core Concepts
π Essential Core Concepts
π Local-First, Least Privilege & Mandatory Approval
Security architecture enforcing Bearer token authentication on all requestsβeven within local LANβwith zero cloud dependencies or external relays.
π± Desktop Approval Remote (Desk Pet)
Always-on tactile PWA turning spare smartphones into a companion cockpit to review and authorize AI agent terminal commands with one tap.
πΎ SQLite WAL & 3-Tier Defense Engine
Write-Ahead Logging (WAL) prevents concurrency lock contention between GUI and HTTP server, backed by strict anti-self-approval protection against RCE.