PandaOSPandaOSby Pandata

Mobile Access

PandaOS includes a mobile companion that lets you monitor and interact with your sessions from your phone, send messages, approve plans, browse files, and more.

How It Works

PandaOS runs a bridge server on your computer that serves a mobile-optimized Progressive Web App (PWA). Your phone connects to this server over your local network (or via Tailscale for remote access).

Setup

  1. Open Settings > Mobile Access

  2. The bridge server configuration shows:

    • Server status, whether the bridge is running
    • QR Code, scan with your phone's camera to connect
    • Connection URL, the local network address (e.g., http://192.168.1.100:3312)

  3. Scan the QR code or enter the URL in your phone's browser

  4. Add to Home Screen for an app-like experience (PWA)

Requirements

  • Your phone and computer must be on the same local network (or connected via Tailscale)
  • The bridge server runs on port 3312 by default
  • The bridge server must be running (check Settings > Mobile Access)

Mobile Interface

The mobile PWA provides a full companion experience for managing your sessions on the go.

Swipe right or tap the hamburger menu to open the Navigation Drawer:

  • Recent sessions, your 10 most recent sessions, sorted by last activity
  • New Chat, start a new session (pick a project and model)
  • Search, jump to the session search view
  • Projects, browse the project grid
  • Archive, view archived sessions
  • Settings, access mobile settings

Projects Grid

Browse all your projects in a responsive card grid. Each project card shows:

  • Project name and path
  • Active session count
  • Dev server status indicator
  • Last activity timestamp

Tap a project to see its sessions, or start a new chat directly.

A dedicated search view for finding sessions across all projects:

  • Text search, filter by session title or message content
  • Project filter, tap project pills to narrow results to a specific project
  • Results update in real-time as you type

Chat View

The full chat experience on mobile:

  • Message thread, PandaOS's Markdown responses with syntax highlighting
  • Tool call pills, compact indicators showing PandaOS's actions (tap to expand)
  • Todo widgets, interactive todo lists from PandaOS's work tracker
  • Thinking indicator, animated indicator with elapsed time while PandaOS is working
  • Subagent cards, nested agent work with expandable timelines
  • Chat input, send messages, attach images, and use the message queue
  • Session browser, swipe between sessions within the same project

Voice Input

Speak your messages instead of typing:

  • Tap the microphone button in the chat input
  • Uses either the Web Speech API (browser-native) or OpenAI Whisper (if an API key is configured in desktop Settings > General > Voice Input)
  • Voice input requires a secure context (HTTPS or localhost)

Plan Approval

When PandaOS proposes a plan, a Plan Approval overlay appears:

  • View the full plan content with Markdown rendering
  • Accept or Reject the plan
  • Provide rejection feedback
  • Access plan history to review past plans

Question Answering

When PandaOS asks a question, a Question overlay appears:

  • View the question and available options
  • Select one or more answers
  • Submit your response

Terminal Access

Open the Terminal sheet from the overflow menu to view the Claude CLI terminal output from the running session.

File Explorer

Open the File Explorer sheet to browse your project files:

  • Navigate the directory tree
  • Tap files to view their contents with syntax highlighting

Git Commits

Create git commits from mobile via the Commit sheet:

  • View staged and unstaged changes
  • Write a commit message
  • Generate a commit message with AI

Settings on Mobile

The mobile settings view provides:

  • Theme selection, apply any of PandaOS's themes
  • Model selection, change the default model
  • MCP server management, view, add, and remove MCP servers

Tailscale Support

For remote access outside your local network, connect your devices via Tailscale. Configure the Tailscale hostname in the Mobile Access settings, the QR code will update to use your Tailscale address so you can access PandaOS from anywhere.

Building the Mobile PWA

The mobile PWA is a separate build from the main Electron app:

npm run build:mobile

This outputs to out/mobile-pwa/ and is served by the bridge server. Changes to mobile code require a rebuild, it does not use HMR.

Python Environments

PandaOS detects Python virtual environments in your projects and can automatically activate them for every command PandaOS runs.

Dev Server Management

PandaOS can detect, start, and manage your project's development server, integrating it with the Browser Preview for a seamless development experience.