Mobile & Remote Access

Overview

Access Open Poet from your phone, tablet, or any device. The mobile interface is optimized for touch, supports voice input, and can be installed as a native-like app on your home screen. Secure remote access lets you manage your projects from anywhere.

Mobile Interface

The mobile UI is optimized for touch interaction:

Bottom navigation bar — fixed at the bottom for easy thumb access with icon + label navigation items.
Touch-optimized spacing — larger tap targets and responsive typography scaling.
Long-press tooltips — any button with a title attribute shows a tooltip on long-press (400ms activation, 1200ms auto-dismiss). No per-button wiring needed — uses document-level event delegation.
Swipe gestures — swipe navigation for common actions.

Mobile Terminal

The mobile terminal provides a complete interactive experience:

Inline input — text input bar at the bottom for quick commands.
Full-screen editor — expand to a full-screen textarea for longer, multi-line input.
Scroll navigation — up/down buttons for browsing terminal history.
Special keys — quick access to terminal control keys (Ctrl+C, Escape, Tab, arrow keys).

Voice Input

Open Poet includes built-in voice-to-text transcription powered by OpenAI Whisper or Groq:

Setup

Provide your API key via CLI flag or environment variable:

Enable voice transcription

# Via CLI flag (OpenAI)
openpoet -openai-key sk-...

# Or via environment variable
export OPENAI_API_KEY=sk-...
openpoet

You can also use Groq as an alternative voice provider by setting GROQ_API_KEY and selecting it in Settings.

Usage

Terminal — tap the microphone button to dictate commands directly to the terminal.
Task forms — use voice input to dictate task descriptions.
Full-screen editor — voice button in the editor appends transcribed text.

Behavior

Records audio in WebM format (with Opus codec preferred, MP4 fallback for Safari).
Maximum recording duration: 60 seconds (auto-stops with an audio notification).
Recording timer displayed in real-time, with a visual warning at 55+ seconds.
Audio is sent to POST /api/voice/transcribe for processing.

PWA Installation

Open Poet works as a Progressive Web App for a native-like experience:

Add to home screen — on iOS and Android, add Open Poet to your home screen for quick access.
Standalone mode — runs without browser chrome (address bar, tabs, etc.).
Offline support — Service Worker caches assets for offline availability.
Push notifications — receive notifications for session events and task updates.

Remote Access

Access your Open Poet instance from anywhere using the built-in tunnel system:

Enable remote access in Settings > Remote Access.
All HTTP and WebSocket traffic is proxied securely through the tunnel.

Device Pairing

Pair mobile devices to your Open Poet instance using two methods:

Method	How it works
QR Code	Scan the QR code displayed on the desktop pairing screen with your phone's camera.
6-Digit Code	Enter the 6-digit code shown on the desktop into the mobile pairing screen.

Paired devices receive a JWT token valid for 30 days. You can revoke device access at any time from the Settings panel.

Security

JWT-based authentication — device tokens with 30-day expiration.
AES-256-GCM encryption — all tunnel traffic is encrypted end-to-end.
Device management — view and revoke paired devices from Settings.
All requests authenticated — tunnel proxied requests carry the device token.

Themes

Open Poet includes 13 built-in themes for both desktop and mobile. See the full list on the Configuration page.

Switch themes from Settings > Appearance. The selected theme persists across sessions and syncs with the PWA.