How sarveshsivasankaran/phonebox-ai works
PhoneBox pairs an Android desk-panel app with a cross-platform desktop agent. Users pair a phone over USB or Wi-Fi, configure pages and widgets, then view computer, AI-session, media, and automation data or send touch-control actions. The agent also supports integrations such as Home Assistant, GitHub, OBS, and AI coding tools. The README describes the editor and widget breadth; sampled source shows selected agent services and Android wiring, so unsampled capability links are omitted rather than inferred.
Main entry points: Program.cs HTTP agent · MainActivity.kt Android panel · PushStore.cs Push state · RuleEngine.cs Rule engine
Components 24
Phone connection
- Android panel
android/app/src/main/java/net/oxog/phonebox/deskpanel/MainActivity.kt - Agent link
android/app/src/main/java/net/oxog/phonebox/deskpanel/AgentLink.kt - Event stream
android/app/src/main/java/net/oxog/phonebox/deskpanel/AgentStream.kt
Agent services
- HTTP agent
agent/PhoneBox.Agent/Program.cs - Configuration
agent/PhoneBox.Agent/Config.cs - Push state
agent/PhoneBox.Agent/PushStore.cs - Updates
agent/PhoneBox.Agent/UpdateService.cs - App paths
agent/PhoneBox.Agent/AppPaths.cs
Monitoring and AI
- PC monitoring
agent/PhoneBox.Agent/SystemMonitor.cs - Calendar
agent/PhoneBox.Agent/CalendarMonitor.cs - Ping monitor
agent/PhoneBox.Agent/PingMonitor.cs - AI sessions
agent/PhoneBox.Agent/SessionMonitor.cs - AI quotas
agent/PhoneBox.Agent/QuotaMonitor.cs - GitHub activity
agent/PhoneBox.Agent/GitHubMonitor.cs - CodexBar
agent/PhoneBox.Agent/CodexBar.cs
Controls and automation
- Rule engine
agent/PhoneBox.Agent/RuleEngine.cs - Shortcuts
agent/PhoneBox.Agent/Shortcuts.cs - OpenCode approvals
agent/PhoneBox.Agent/OpenCodeApprovals.cs - Approval store
agent/PhoneBox.Agent/ApprovalStore.cs - Control Deck
agent/PhoneBox.Agent/ControlDeck.cs - Media controls
agent/PhoneBox.Agent/SpotifyControl.cs - Home Assistant
agent/PhoneBox.Agent/HomeAssistant.cs
Other components
- Phone user
- External services
Connections 22
- Phone user → Android panel: uses
README.md - Android panel → Agent link: creates link
android/app/src/main/java/net/oxog/phonebox/deskpanel/MainActivity.kt - Android panel → Event stream: creates stream
android/app/src/main/java/net/oxog/phonebox/deskpanel/MainActivity.kt - Android panel → HTTP agent: connects to
README.md - HTTP agent → Push state: uses
agent/PhoneBox.Agent/Program.cs - HTTP agent → PC monitoring: uses
agent/PhoneBox.Agent/Program.cs - HTTP agent → Updates: routes updates
agent/PhoneBox.Agent/Program.cs - Push state → App paths: persists through
agent/PhoneBox.Agent/PushStore.cs - HTTP agent → Configuration: reads settings
agent/PhoneBox.Agent/Program.cs - AI quotas → CodexBar: uses
agent/PhoneBox.Agent/QuotaMonitor.cs - GitHub activity → External services: queries GitHub
README.md - AI sessions → GitHub activity: uses
agent/PhoneBox.Agent/SessionMonitor.cs - Rule engine → Push state: writes events
agent/PhoneBox.Agent/RuleEngine.cs - Rule engine → AI sessions: observes
agent/PhoneBox.Agent/RuleEngine.cs - Rule engine → Shortcuts: runs
agent/PhoneBox.Agent/RuleEngine.cs - OpenCode approvals → Approval store: uses
agent/PhoneBox.Agent/OpenCodeApprovals.cs - OpenCode approvals → Push state: notifies
- Control Deck → External services: controls OBS
README.md - Media controls → External services: controls media
README.md - Home Assistant → External services: connects
README.md - Calendar → HTTP agent: serves data
agent/PhoneBox.Agent/Program.cs - Ping monitor → HTTP agent: serves data
agent/PhoneBox.Agent/Program.cs