phonebox

PhoneBox has two parts: a small Android app that runs full screen on the phone, and an agent on the computer (Windows, Linux or macOS) that feeds it over the USB cable (or over Wi-Fi / Tailscale after pairing once). You design the pages in a visual editor on the PC: 53 widgets, 23 templates, as many pages as you like.

• Your PC at a glance: CPU, GPU, RAM, disks, network and ping; the heaviest apps, with "end one instance / end all".
• AI coding: Claude and Codex quotas with a burn-rate forecast; every Claude Code / Codex session — the phone buzzes when one finishes or needs you, and Claude Code's permission prompts show up with Allow / Deny. GitHub review requests and your pull requests with CI status.
• Desk companion: now playing with controls and volume, clocks, weather, sun & moon, air quality, calendar, pomodoro, timers, checklists, notes, a breathing exercise.
• Stream Deck–style keys that launch apps, URLs or built-in actions on the PC.
• Webhooks and rules: scripts, CI and Home Assistant push values and notifications; rules switch pages calmly when something happens (a call, music, an AI session waiting for you).

Contents: Quick start · Pages & templates · Widgets · Layout editor · Claude Code prompts · Webhooks · Rules · Wi-Fi & Tailscale · Updates · How it works · Security · FAQ · Development

Quick start

You need an Android 9+ phone with USB debugging turned on, the .NET 10 SDK and adb.

Windows 10/11

winget install Microsoft.DotNet.SDK.10 Google.PlatformTools   # .NET 10 and adb
git clone https://github.com/ersinkoc/phonebox
cd phonebox
.\scripts\install.ps1 -Apk -Autostart   # agent + phone app, start with Windows (add -Serial <id> if several devices are connected)

Or install just the agent with Scoop and let it put the app on the phone (settings › General › Install the phone app, with the phone plugged in):

scoop bucket add phonebox https://github.com/ersinkoc/phonebox
scoop install phonebox/phonebox          # needs the .NET 10 Desktop Runtime and adb (scoop install extras/windowsdesktop-runtime main/adb)

A winget package (ersinkoc.PhoneBox) is prepared in packaging/winget for submission to winget-pkgs; once accepted it installs with winget install ersinkoc.PhoneBox.

Linux (Ubuntu, Debian, Fedora, Arch…) and macOS

sudo apt install adb playerctl          # Fedora: android-tools playerctl · macOS: brew install android-platform-tools
git clone https://github.com/ersinkoc/phonebox
cd phonebox
./scripts/install.sh --apk --autostart  # agent + phone app; systemd user service (Linux) or launchd agent (macOS)

Plug the phone in: it wakes up and opens the panel. The settings are at http://127.0.0.1:8765 (on Windows also from the tray icon). scripts/uninstall.ps1 [-Purge] [-Apk] / scripts/uninstall.sh [--purge] [--apk] remove everything again.

Optional extras that light up more widgets: an NVIDIA GPU (nvidia-smi), the GitHub CLI (gh auth login), Claude Code, Codex, and LibreHardwareMonitor with its web server on port 8085 for the CPU temperature.

Pages & templates

Every page is a 12 × 6 grid. Start a page from one of the 23 templates (or from scratch) and change anything.

More templates: Clock, Focus (pomodoro + note), Calm (breathing), DevOps (command widgets) and Weekend (forecast, music, moon, analog clock, quote).

Getting around. Swipe; press the phone's volume keys to flip pages; tap the page dots (or long-press an empty spot) for an overview of all pages and jump straight to one. Webhooks and rules can switch pages too; they count down first ("switching to AI in 3…", with Stay and Go now) and never pull a page away while you are using the panel. The panel returns to the home page when idle (each page can stay longer, or for good), can dim to a clock at night and keeps the screen on.

Widgets