
21.79 MB
Android 8.0+
15
x86_64, arm64-v8a, armeabi-v7a, x86
Verified safeScanned with ClamAV, APKiD, and Quark-Engine. No threats detected.
What's New
https://github.com/alexeygrigorev/pocketshell/compare/v0.2.8...v0.2.9/
Description
PocketShell turns your Android phone into a voice-first cockpit for the tmux sessions and AI coding agents running on your dev box.
It is built around persistent tmux sessions (via tmux -CC control mode), touch-friendly per-pane rendering, voice/prompt composition, and AI-agent awareness — instead of treating the phone as a small desktop terminal.
Features
- Persistent tmux sessions via tmux -CC control mode. Per-pane rendering: one pane at a time on a real VT emulator, swipe between panes and windows. Detach without killing the local view, reattach without re-rendering.
- Voice-first composer. Whisper (via OpenAI Audio Transcriptions) with live partial transcription, editable text area, inline dictation into the terminal, key bar for keys phones lack, snippet library, command chips.
- Agent-aware conversation view. Detects Claude Code, Codex, and OpenCode in the active tmux pane and renders a clean read-only conversation surface by tailing the JSONL log over SSH. Tool calls collapsible, search within session, long-press to quote-reply. Codex and OpenCode detection fires once the agent has flushed at least one turn to its rollout JSONL (the per-pane detector uses a 2-hour freshness window so a mid-session Codex pane still registers after a pause between turns). Real-world OpenCode that persists to a SQLite opencode.db rather than JSONL is still pending a dedicated reader.
- Usage dashboard. Per-provider quota (Claude, Codex, Copilot, Z.AI) via the server-side pocketshell usage helper. Zero credentials on the phone — the helper polls each provider on the host and the phone is a viewer.
- QR-code host pairing. Single-frame or multi-part QR import of host
- key in a versioned payload (pocketshell.ssh-import.v1). Manual entry remains available. See docs/ssh-qr-import.md.
- Background-free design (D21). No WorkManager, no AlarmManager, no scheduled work on the phone. tmux on the remote keeps long-running state; the app reconnects on next foreground. The one scoped carve-out is the auto-forward foreground service when tunnels are active.
- Unified pocketshell daemon mode. The Python helper offers a lazy-spawned daemon (Unix socket, JSON-RPC, 30s TTL cache) so repeat usage calls return in sub-second time; ~92x speedup observed on cached usage --json invocations versus the cold-spawn path. The daemon currently covers usage.fetch; remaining subcommands (jobs, sessions, repos) extend onto the same IPC layer in follow-up rounds.
- Share-target dispatch. From any Android app, share text into PocketShell to either paste into the currently-attached session or save as a file on the remote host.
- Port forwarding. Auto-forward modules ported from ssh-auto-forward-android. Per-host port table, restart on transport bounce.
Rate this app
Ratings & reviews
No reviews yet.