PhoneBox turns a spare Android phone into a local control deck for your PC — including Claude Code quotas, Codex burn rates, and GPU charts — without signing up for a cloud dashboard. The ersinkoc/phonebox repo gained roughly 2,300 GitHub stars in its first ten days online when we reviewed it on November 17, 2026.
This is not the Canadian PhoneBox mobile carrier that dominates search suggestions for “PhoneBox login” or “PhoneBox esim.” The GitHub project is MIT-licensed desk software pairing a Kotlin Android app with a .NET 10 agent on Windows, Linux, or macOS.
Builders already tracking agent tooling should read this next to Qwen Code, FFmpeg skills for local video MCP, and Together’s coding-agent eval claims.
TL;DR
| Piece | What it does |
|---|---|
| Android app | Full-screen WebView panel, multi-page swipe |
| Desktop agent | Hosts widgets, integrations, local API on 127.0.0.1:8765 |
| Transport | USB adb reverse or HTTPS Wi-Fi on 8766 with pinned cert |
| Editor | Browser UI for 12×6 grid, templates, live preview |
| AI focus | Quotas, sessions, optional Claude Code Allow/Deny on phone |
| Account | None — no PhoneBox telemetry per privacy doc |
Why an old phone beats another SaaS dashboard
Coding agents already spam terminal panes with token counts. PhoneBox centralizes machine health + model quotas + macros on hardware you own. Because the agent keeps API keys and shell commands on the desktop, the phone is a display and tap surface, not a second secrets store — assuming you do not expose the settings server beyond localhost.
That architecture matches how MCP tool binding risks grow when you add remote control planes without pinning trust.
Install path (Windows quick start)
Official README flow on November 17:
irm https://raw.githubusercontent.com/ersinkoc/phonebox/main/setup.ps1 | iex
Linux and macOS use setup.sh via curl. Setup:
- Downloads the latest GitHub release and checks SHA-256
- Can enable start at login
- Opens http://127.0.0.1:8765 for configuration
- Optionally pushes the APK over USB adb
Windows warning: Release agents are unsigned while SignPath approval is pending; expect SmartScreen friction. Read setup.ps1 before running — the repo documents this explicitly.
USB vs Wi-Fi pairing
| Mode | Requires | Best for |
|---|---|---|
| USB | Developer mode + USB debugging authorize | Lowest latency, auto-wake panel |
| Wi-Fi | QR pairing + pinned TLS cert | No cable; manual APK updates |
You can enable both so the phone falls back if the cable drops — useful on a desk that moves between office and bench.
Widget catalog (what matters for AI builders)
PhoneBox advertises 122 widgets and 30 templates spanning:
- System: CPU, GPU, RAM, disks, network, process kill controls
- AI coding: Claude, Codex, Antigravity quota bars, reset timers, burn-rate forecasts
- Sessions: Local Claude Code and Codex session detail panes
- Control deck: Shortcuts, OBS, audio routes, macros
- Automation: Webhooks, Home Assistant triggers tied to desktop events
Optional CodexBar integration adds more quota providers. Opt-in Claude Code permission prompts let you tap Allow or Deny when the agent asks to run a tool — a human-in-the-loop pattern similar in spirit to DIY Pinky phone MCP projects, but with a polished grid UI.
Layout editor workflow
Open the settings URL, pick a template (Home, System, AI quotas, Sessions, Music, Control Deck, etc.), drag widgets on a 12×6 grid, Save, then Live preview unsaved edits against real data.
Smart Stack packs up to twelve mini widgets into one slot — handy for squeezing GPU temp + Claude quota + git CI onto one portrait phone.
Platform caveats
README compatibility table notes:
- Windows x64 has the richest GPU sensor support (NVIDIA via nvidia-smi, extras via LibreHardwareMonitor)
- Linux uses wpctl/pactl for audio; macOS media controls vary by app
- No release builds for Windows ARM or Alpine musl Linux
Widget availability still depends on what you installed locally — playerctl, OBS WebSocket, etc.
Security model
From SECURITY.md and PRIVACY.md themes in the README:
- Settings server binds 127.0.0.1 by default; USB uses adb reverse
- Wi-Fi mode uses pinned certificates and pairing codes
- No first-party telemetry or accounts
- Optional widgets may call weather, GitHub, or quota APIs — each documented in the privacy policy
Threat model reminder: anyone who can reach your agent API could trigger configured actions. Keep Wi-Fi pairing keys private and do not port-forward 8765/8766 to the public internet.
How PhoneBox compares to Stream Deck
| PhoneBox | Elgato Stream Deck | |
|---|---|---|
| Hardware | Reused Android | Dedicated keys |
| AI quota widgets | Built-in | Requires plugins |
| Price | Software + old phone | $100+ new deck |
| Cloud | None required | Optional Elgato account |
PhoneBox wins on AI session visibility; Stream Deck wins on tactile keys and mature plugin stores.
Development and contributing
Stack: .NET 10 agent, Kotlin Android app, widget UI in plain JavaScript inside WebView. Demo without hardware:
python tools/demo-server.py
Then open http://127.0.0.1:8790/panel/ for simulated data.
Project is MIT licensed; maintainer ersinkoc also sponsors WrongStack, an open-source coding agent referenced in the README.
Limitations to expect
- Maintenance: Young repo — expect breaking changes across 300+ commits.
- iOS: Not supported; Android 7.0+ only.
- Enterprise MDM: Unsigned Windows binaries may fail corporate device policy.
- Quota accuracy: Third-party APIs change; verify burn-rate math against vendor consoles.
Who should try it this week
| User | Reason |
|---|---|
| Agent power user | Glance quotas without alt-tabbing terminals |
| Streamer / desk setup | OBS + audio widgets beside AI session panes |
| Hardware hacker | Cheap touch panel vs new macro keyboard |
Tailscale and remote desks
README documents optional Tailscale pairing so a phone on another VLAN can still reach the agent when you accept the operational risk. That is convenient for home lab setups; it is not recommended without firewall rules because you are extending a machine-control API beyond localhost.
Uninstall and updates
Re-running setup.ps1 or setup.sh repairs or upgrades while keeping pairings, per README. Uninstall steps live in the installation guide (remove autostart entry, delete install dir, revoke adb keys on the phone).
Widget JSON and automation rules
Power users can chain webhook widgets to Home Assistant or custom scripts when the desktop agent fires events — for example dimming lights when a long Claude Code job starts. Treat webhook URLs like passwords if they trigger privileged scripts.
Accessibility and desk ergonomics
Mount the phone at eye level beside your monitor so quota widgets stay in peripheral vision. Portrait vs landscape layouts are both supported; landscape fits Control Deck templates with more horizontal macro keys.
Corporate environments
Unsigned Windows binaries may trigger Defender Application Control blocks. IT teams can rebuild from source per the development guide, or wait for SignPath signing noted in the README footer.
FAQ alignment for confused searchers
If you landed here after searching PhoneBox Canada login, PhoneBox esim, or PhoneBox Malta, you want the MVNO carrier — not this repo. The GitHub project’s FAQ above clarifies that distinction so you do not install desktop agents expecting a cell plan portal.
Integration with Claude Code workshops
Teams running live Claude Code workshops can demo PhoneBox as a quota visibility teaching prop: students see when a shared org limit resets without opening a vendor web console.
Day-in-the-life workflow example
Morning: USB dock wakes the phone, Sessions page shows overnight Claude Code job still within quota. Afternoon: drag GPU temp widget next to Codex burn rate when running parallel agents. Evening: switch to Music page without losing agent state because layouts are per-page, not per-app restart.
Pairing with CodexBar and GitHub widgets
README mentions optional CodexBar for extra quota providers. GitHub review widgets need tokens stored on the desktop agent — rotate them like any local PAT and scope read-only unless you accept merge risk from the panel.
What is not verified
We did not independently audit CodexBar math or Claude quota API stability. Widget numbers reflect whatever providers return at runtime.
Related reading
- Qwen Code terminal agent
- FFmpeg skill for coding agents
- Together AI agent evals coverage
- MCP tool misbinding security
- Pinky phone MCP human-in-the-loop
- Claude HTML in Canvas artifacts
- Mobile AI factory on-device agents
- Gemini Intelligence widgets on Android
Scoop and winget packaging
Windows users can add the community Scoop bucket from the repo and install phonebox plus adb in one line, which helps lab machines that block random .exe downloads without a package manager trail. winget manifests sit under packaging/winget/ but may lag GitHub Releases — check version numbers before filing internal IT tickets.
Template gallery for agent-first desks
Start from the AI quotas or Sessions template, then delete music widgets you do not need. Keep one page for machine health and one page for agent limits so you do not scroll during incident response. Control Deck templates map well to OBS scenes if you stream coding sessions.
Battery and thermal notes on old phones
Always-on dashboards keep screens awake; use developer charging limits or a Powered USB hub so a 2018 phone does not balloon its battery. Lower refresh by disabling animations in the Android app settings if your device thermally throttles during summer desk sessions.
Primary sources: ersinkoc/phonebox on GitHub and PhoneBox documentation site, accessed November 17, 2026.
