pi-mobile

PWA mobile app for Pi coding agents. Mounts on pi-webserver at /mobile, giving you mobile control over any Pi agent.

Screens

| Tab | Description | |-----|-------------| | 💬 Chat | Send messages with streaming responses via SSE. Type /commands to invoke extension commands, skills, or prompt templates | | 📊 Status | Agent health, system metrics, uptime, tool count | | 📋 Tasks | td issue list with filters, create/update tasks | | 📁 Files | Browse workspace files, view content | | 📜 Logs | Live log stream with level filters | | ⏰ Cron | Manage scheduled jobs — toggle, run, view schedule | | 🧠 Skills | Browse registered tools with search | | 👥 CRM | Contact list with search (via pi-personal-crm) | | 📅 Calendar | Upcoming events (via pi-calendar) | | 🧩 Extensions | View installed extensions and their tools | | ⚙️ Settings | Connection config, API key, theme |

Setup

1. Install the extension

Add pi-mobile to your Pi extensions:

# Symlink to extensions directory
ln -s ~/Dev/pi-mobile ~/.pi/agent/extensions/pi-mobile

# Install dependencies
cd ~/.pi/agent/extensions/pi-mobile
npm install

Or add to settings.json:

{
  "extensions": ["~/Dev/pi-mobile"]
}

2. Ensure pi-webserver is running

pi-mobile mounts on the shared pi-webserver. Make sure pi-webserver is enabled.

3. Access the app

http://localhost:<webserver-port>/mobile

Install as PWA

iOS (Safari)

1. Open /mobile in Safari
2. Tap Share (📤) → Add to Home Screen → Add

Android (Chrome)

1. Open /mobile in Chrome
2. Tap ⋮ → Install app → Install

Remote Access via Tailscale

1. Install Tailscale on both devices
2. Access via Tailscale hostname:

http://your-machine.tail12345.ts.net:<port>/mobile

Important: Set an API key when binding to external interfaces:

{
  "pi-webserver": {
    "bind": "0.0.0.0",
    "apiKey": "your-secret-key"
  }
}

Architecture

pi-mobile/
├── src/
│   └── index.ts          # Extension + API endpoints + SSE broadcasting
├── public/
│   ├── app.html          # SPA — 11 Preact screens, dark theme (no build step)
│   ├── manifest.json     # PWA manifest
│   └── sw.js             # Service worker
├── package.json
├── tsconfig.json
├── AGENTS.md
└── README.md

Tech Stack

• Preact + HTM from esm.sh CDN — no build step
• CSS Custom Properties — dark mode theming
• Service Worker — offline caching (stale-while-revalidate)
• SSE — real-time agent events and log streaming
• pi-webserver — shared HTTP server with event-bus mount system