pocketagents
oscarka/pocketagents
PocketAgents (formerly deepseekharness-remotecontrol): self-hosted mobile Web PWA and Feishu remote control hub for DeepSeek Harness plus local adapters for Antigravity IDE, Codex, Claude Code, WorkBuddy and Doubao, with swipe-triage approvals, multiple-choice popup replies, hold-to-talk voice steering, TTS reply playback, HLS/WebRTC media preview, multi-host pinning, Web Push notifications, and 5-second terminal QR pairing.
설치
dsh plugin --profile web add github:oscarka/pocketagentsREADME
PocketAgents — Control Claude Code, OpenAI Codex, Antigravity IDE, DeepSeek Harness (DSH) & WorkBuddy from your phone — 100% self-hosted, zero vendor relay.
Swipe-approve shell commands, answer multiple-choice popups, steer running tasks with Hold-to-Talk voice, or listen to replies with 🔊 Listen.
⚡ Try on your own Mac / Linux in 5 seconds (same Wi-Fi · terminal QR code · zero config):
npx pocketagents
Opens a local Hub, auto-discovers your Claude Code / Codex / Antigravity / DSH sessions, and prints a scannable QR code right in your terminal.
🇺🇸 English · 🇨🇳 简体中文 · ✨ Live Demo · 24/7 Cloud Setup · Supported Tools · What's New · FAQ
![]() ① Unified 5-Tool Session List Live tasks across Claude Code, Antigravity IDE, Codex, DSH & WorkBuddy with Pinned Conversations & unread dots |
![]() ② Swipe Triage Deck Swipe right to approve shell commands, answer multiple-choice popups, or hold-to-talk an alternative instruction |
![]() ③ Approve, Voice & Listen 1-tap approvals, WeChat-style Hold-to-Talk voice, 🔊 Listen TTS & live HTML deliverable previews
|
🎬 15-Second Live Walkthrough: Computer pauses on a test command → Open mobile PWA & tap
Submit ↵ → Computer immediately runs all 42 tests & syncs the conclusion back to your phone.
Why Mobile Remote Control for AI Coding Agents?
When you kick off a long refactoring, test suite, or deployment in Claude Code, OpenAI Codex, Antigravity IDE, DeepSeek Harness (DSH), or Tencent WorkBuddy, stepping away from your desk usually means flying blind:
- Stuck on a popup: The agent asks "Allow
npm run test:integration?" or pops up an architecture multiple-choice question — and waits for hours until you return to your keyboard. - No visibility on the go: You want to check whether the task finished, hold-to-talk a quick voice instruction, attach a phone screenshot, or hit emergency stop while away from your desk.
- Multiple computers: You have both an office Mac and home workstations running tasks and want one unified mobile view.
PocketAgents puts all of your computers' AI coding sessions into a clean mobile web app (with WeChat-style Hold-to-Talk voice input + smart punctuation, 1-tap 🔊 Listen algorithmic reply playback (⚡ Summary / 📖 Full + seamless mid-stream speed control), iOS 16.4+ Home Screen lock-screen push notifications, and automatic English/Chinese UI detection).
How It Works: Self-Hosted Architecture (No Vendor Relay Required)
Before starting, it helps to understand the two lightweight pieces and how data flows between them:
┌──────────────────────────┐ HTTPS / Live SSE ┌─────────────────────────────────┐
│ 📱 Your Phone PWA │ ◄─────────────────────────────► │ 🏠 Your Self-Hosted Hub │
│ Approve · Steer · Files │ │ (Your Mac / NAS / VPS / Cloud) │
└──────────────────────────┘ └────────────────┬────────────────┘
│ Outbound HTTPS
┌────────────────────────┴────────────────────────┐
▼ ▼
┌─────────────────────────────────┐ ┌─────────────────────────────────┐
│ 💻 Computer A (Office MacBook) │ │ 💻 Computer B (Home Workstation)│
│ DSH · Antigravity · Codex │ │ DSH · Codex · WorkBuddy │
└─────────────────────────────────┘ └─────────────────────────────────┘
- Control Hub (
控制台): A tiny, zero-dependency Node.js web server that you deploy yourself (on Railway, your own VPS/Cloudflare CDN, NAS, computer, or Cloud Run). You never have to route your sessions through a third-party vendor's central SaaS relay. - Computer Daemon (
connect-host.sh): A background agent installed on each of your Mac/Linux computers via a 1-line command. It watches your local AI coding sessions and connects outbound to your Control Hub (so your computer does not need a public IP or port forwarding).
Transparent Data Boundary: Your self-hosted Control Hub holds recent session metadata and active conversation snapshots in memory so your phone can open chats instantly. Full project source files, screenshots, and videos stay on your computers and stream directly on demand over a dedicated reverse HTTP tunnel (
HTTP 206 Rangevideo scrubbing, smart thumbnails, and short-lived read-onlymediaTicketURLs that never exposeHUB_TOKEN). Share links (/share/:id#k=...) use client-side AES-256-GCM end-to-end encryption. SeeSECURITY.mdfor full details.
Get Started in 3 Steps
⚡ 5-Second Local Tryout via
npx(Works with Claude Code, Codex, Antigravity IDE, DSH & WorkBuddy — Zero Config):npx pocketagentsStarts a local Control Hub + session watcher in 3 seconds, auto-enables Claude Code mobile approvals, and prints a scannable QR code right in your terminal (same Wi-Fi, 1-tap passwordless phone login — no
git clone, no Railway, no config files).🔌 Install as a Native Agent Plugin (GitHub direct — no store signup required):
- Antigravity:
git clone --depth 1 https://github.com/oscarka/pocketagents ~/.gemini/config/plugins/pocketagents- Claude Code (includes zero-hang
PermissionRequesthook +pocketagentsskill):/plugin marketplace add oscarka/pocketagents /plugin install pocketagents@pocketagents- OpenAI Codex (ships
.agents/plugins/marketplace.json+.codex-plugin/plugin.json): Addoscarka/pocketagentsvia Codex/plugins(auto-discoversplugins/pocketagents).- DeepSeek Harness (DSH >= 0.2.0) (also available in DSH Market):
dsh plugin --profile desktop add github:oscarka/pocketagents # Or use --profile web if you run `dsh web`Ready for 24/7 cellular (4G/5G) access across multiple computers? Follow the 3 steps below:
Step 1: Start Your Control Hub (Pick 1 of 4 Ways)
Choose the deployment method that best fits how you use your phone:
🌟 Option A: 1-Click Cloud Deploy on Railway (Recommended · Fastest 24/7 4G/5G Access, No CLI Required)
If you want to control your home/office computers from anywhere on cellular 4G/5G without installing cloud CLIs or managing servers, click the Deploy on Railway button at the top of this README (or open the official template directly):
- Automatically generates a strong
HUB_TOKENpassword (or customize it to your own strong password before clicking Deploy). - Provisions a ready-to-use
https://...URL in1 minute with native SSE streaming and predictable low monthly cost ($5/mo Hobby plan for 24/7 connected hosts).
🏠 Option B: Run Locally on Your Computer (Fastest 30s Tryout · Same Wi-Fi, $0 Cost)
No cloud account or Docker needed. Clone the repo and start the Control Hub directly on your computer (requires Node.js >= 20):
git clone https://github.com/oscarka/pocketagents.git
cd pocketagents
# Replace choose-a-password with your own password
HUB_TOKEN="choose-a-password" PORT=8080 npm start
The terminal will print both http://localhost:8080 and your LAN URL (e.g. http://192.168.1.x:8080).
🐳 Option C: VPS / NAS / Raspberry Pi (Docker or Cloudflare CDN / Tunnel)
If you have a lightweight VPS (e.g. paired with Nginx + Cloudflare HTTP/2 & HTTP/3 CDN), home server, NAS, or Raspberry Pi, run the prebuilt Docker image (or npm start + cloudflared tunnel --url http://localhost:8080):
docker run -d --name pocketagents-hub \
--restart unless-stopped \
-p 8080:8080 \
-v dsh-hub-data:/data \
-e HUB_TOKEN="choose-a-password" \
ghcr.io/oscarka/pocketagents:latest
☁️ Option D: Google Cloud Run (CLI Script Deploy)
If you prefer deploying on GCP via gcloud, use the bundled helper script (note: because connected computer daemons keep persistent 24/7 SSE/heartbeat streams open, Cloud Run remains resident while hosts are online rather than scaling to zero — for always-on multi-computer setups, Railway or a lightweight VPS is usually much more cost-effective):
git clone https://github.com/oscarka/pocketagents.git
cd pocketagents
# Replace with your GCP project ID and your chosen password
GCP_PROJECT_ID="your-gcp-project-id" \
HUB_TOKEN="choose-a-strong-password" \
./deploy-cloudrun.sh
Once deployed, the script prints your https://dsh-remotecontrol-hub-xxx.run.app URL.

Step 1 Result: Open your Control Hub URL in your computer browser and enter your
HUB_TOKEN password (tap 🌐 EN / 中文 top-right to switch language).
Step 2: Connect Your Computer (1-Line Command)
After unlocking the Control Hub on your computer browser, you will see the Connect Your Computer in 3 Steps card with a 15-minute enrollment code:
- Click
📋 Copy 1-Line Install Command(or📋 Copy Local Repo Commandif you already cloned the repo). - Paste and run it in your computer's terminal:
curl -fsSL https://your-hub-url/install.sh | bash -s -- --code ABCD-1234 - The script automatically registers your computer with a dedicated revocable credential, installs the background LaunchAgent/systemd service, and connects live within 2 seconds.

Step 2 Screen: Copy the 1-line command from the onboarding card and run it in your computer terminal.
Step 3: Scan QR Code on Your Phone (Passwordless Login)
- In your computer browser, click
📱 Phone QR Login. - Point your phone's camera at the QR code on screen — your phone logs in immediately without typing the password!
- Smart LAN Detection: If you opened
http://localhost:8080on your computer, the QR sheet automatically switches the QR code URL to your computer's LAN IP (http://192.168.x.x:8080) so your phone on the same Wi-Fi connects on the first try.
- Smart LAN Detection: If you opened
- Optional (Recommended on iPhone): In Safari, tap Share → Add to Home Screen, open the app from your Home Screen, and enable Lock-Screen Push in Settings to receive instant alerts when a task finishes or needs approval.

Step 3 Screen: Scan the QR code with your phone camera for instant passwordless login.
Supported AI Coding Tools
The background daemon automatically discovers local sessions across all 6 supported coding tools on your machine:
| AI Coding Tool | View Live Sessions | New / Resume Prompt | Emergency Stop | Mobile Approval & Question Popups | Live Mid-Run Steer |
|---|---|---|---|---|---|
| DeepSeek Harness (DSH) | ✅ | ✅ | ✅ | ✅ (Shell approvals + ask_user_question / exit_plan_mode cards) | ✅ |
| Antigravity IDE | ✅ | ✅ | ✅ | ✅ (Connect-RPC + native keystroke injection) | ✅ |
| OpenAI Codex | ✅ | ✅ (codex app-server + codex exec fallback) | ✅ | ✅ (JSON-RPC approvals & question cards via app-server) | ✅ |
| Tencent WorkBuddy | ✅ | ✅ (ACP HTTP+SSE) | ✅ | ✅ (ACP permission popups) | ✅ |
| Claude Code | ✅ | ✅ (via claude --resume) | ✅ | ✅ (Native PermissionRequest Hook: Bash, Edit, Write, MCP & AskUserQuestion) | — |
Doubao Desktop (豆包电脑版) | ✅ (Observe-only) | — | — | — | — |
📅 What's New (Recent Releases)
💡 Grouped one drawer per day with every exact version tag preserved inside; see
CHANGELOG.mdfor granular per-release notes.
2026-11-20 · v0.9.1–v0.9.4 — Swipe Triage TTS, Bidirectional Multi-Host Rename Sync & Native Antigravity / Claude Code / Codex Plugins
- Swipe Triage
🔊 ListenTTS & Automatic Multi-Computer Legacy Rename Migration (v0.9.4): Added 1-tap🔊 Listen/⏹ Stop/⚡ Summary | 📖 Full/1x–1.5xplayback directly on Swipe Triage conclusion cards and expanded full-reply modals (with silent cold-hydration upgrade and auto-mute on swipe/mic); addedHubAgent.migrateLegacyCustomTitles()on daemon boot so every enrolled computer automatically migrates its own legacy~/.dsh/session-titles.jsontitles into Antigravity IDE, Claude Code & DSH after clicking 1-tap Host Upgrade. - Bidirectional Session Rename Sync Across All 5 Harnesses (
v0.9.3): Added nativesetAntigravityConversationTitle(Connect-RPCUpdateConversationAnnotationsannotations.title+ atomic.pbtxtfallback preservingpinned:true), Claude Code.jsonlcustom-titleread/write, and offline DSH zstdsession/titleframe append; automatically clears stale~/.dsh/session-titles.jsonoverrides so desktop renames never get permanently shadowed, with optimistic mobile title updates. - Native Multi-Platform Agent Plugins & Zero-Hang Claude Hook (
v0.9.2): Added native GitHub-installable plugin manifests for Antigravity (plugin.json+skills/pocketagents/SKILL.md+assets/logo.svg), Claude Code (.claude-plugin/plugin.json,.claude-plugin/marketplace.json, isolated.claude-plugin/hooks.json), and OpenAI Codex (.codex-plugin/plugin.json+.agents/plugins/marketplace.json→plugins/pocketagents), validated withagy plugin validateandclaude plugin validate; added live watcher heartbeat/lock checks and--from-plugindeduplication toclaude-permission-hook.jsso stopped daemons never block Claude Code terminals. - Unified
pocketagentsLaunch (v0.9.1): Aligned GitHub repo (oscarka/pocketagents), npm CLI (npx pocketagentswith OIDC provenance), multi-arch GHCR image (ghcr.io/oscarka/pocketagents:latest), and live sandbox (https://pocketagents.agentrun.vip/?demo=1); tightened mobile chat swipe-back strictly to rightward drags from the left edge (14%,48–72px) and fixed 4 conclusion unread bugs (stale Antigravitycreated_attimestamps, fastidle -> idleturn detection, non-conclusion read receipt overwrites, and backgroundvisibilityState === 'hidden'auto-reads).
2026-11-19 · v0.8.9–v0.9.0 — PocketAgents Rebrand (npx pocketagents), Claude Code Approvals, Antigravity ask_question & ?demo=1 Sandbox
-
PocketAgents Launch (
v0.9.0): Rebranded repository and primary CLI package to PocketAgents (github.com/oscarka/pocketagents,npx pocketagents,ghcr.io/oscarka/pocketagents:latest) with automatic 301 redirect from legacydeepseekharness-remotecontrollinks and full DSH Market compatibility. -
Antigravity
ask_questionInteractive Options & Reliable Resume (v0.8.20–v0.8.21): Parsedask_questionquestions& hydrated truncatedtool_callsfromtranscript_full.jsonlinto structuredkind: 'question'cards (fixing the genericYes, allow this timefallback), and cleanly cancelled the waiting step before delivering the user's selected choices viaSendUserCascadeMessageso Antigravity resumes running immediately instead of treating it as a skipped popup. -
Native Claude Code Mobile Approvals (
v0.8.19): Added official Claude CodePermissionRequestHook bridge (claude-permission-hook.js+--install-claude-hook/ auto-install innpx), real-time<120msFSEvents approval watcher, 1-tapAllow/Always allow in this chat(updatedPermissions) /DenyandAskUserQuestionstructured answers — bringing full mobile & Swipe Triage approvals to all 5 coding harnesses (Claude Code, Codex, Antigravity IDE, DSH & WorkBuddy). -
1-Command
npxTerminal QR & Zero-Backend Interactive Demo (v0.8.18): Added executablenpx deepseekharness-remotecontrol(dsh-remote) CLI that boots an embedded local Hub + local session watcher and prints a scannable ISO/IEC 18004 Unicode QR code right in the terminal; shipped a completely isolated, zero-backend?demo=1interactive sandbox (2 hosts, 5 AI engines, Swipe Triage, HTML live preview) and repositioned README & visuals for Claude Code, Codex, Antigravity IDE & DSH. -
Explicit Interruption Notices & Latest-Turn Previews (
v0.8.16–v0.8.17): ResetlastOutputon each newUSER_INPUTand aligned list previews strictly to the newest transcript message so stalled turns never leak older replies; collapsed repeated AntigravityERROR_MESSAGEstream drops (⚠️ Interrupted (×N)) into standalone notices with⚠️ Interruptedstatus and added an inline resume banner when a turn pauses after tool steps. -
Zero-Lag Conclusion State Sync (
v0.8.15): Removed CDN-bufferedgzipencoding on/api/eventsSSE (80msdefault /30msurgent conclusion flush), wired Service WorkerPUSH_RECEIVED+NOTIFICATION_CLICK+1.2sforeground resume to force immediate/api/staterefresh, prunedinflightCommandsimmediately on conclusion, and cut AntigravityRUNNINGRPC cache TTL from2.5sto350ms. -
Bidirectional Multi-Harness Session Pinning & Zero-Flake CI (
v0.8.13–v0.8.14): Added Hub-persistedsessionPinState(POST /api/sessions/pin+ SSE), mobile📌 Pinned Conversationssection headers, and 2-way native sync across Antigravity IDE (annotations/<convId>.pbtxt+ Connect-RPCUpdateConversationAnnotations+ FSEvents watch), DSH Desktop (workspace.json), Codex Desktop (.codex-global-state.jsonincl. Electron atom state), WorkBuddy (workbuddy.db+pinned-sessions.json), and Doubao (LevelDBpinned); enforcedsqlite3.timeout 5000+ WAL and--test-concurrency=4to eliminate CISQLITE_BUSYflakes. -
Clickable User-Bubble Image Thumbnails & Sticky-Bottom Scroll Lock (
v0.8.12): Replaced raw upload path text inside user bubbles with clickable fixed-aspect image thumbnails (.dsh-uploads/.user_uploadedfallback, zoom & save); upgraded chat scrolling to a gesture-drivenchatPinnedToBottomstate machine + capture-phase<img>load&ResizeObserveranchoring to prevent sudden upward jumps. -
Theme-Aware Artifact/Diff Cards & Drag-Up Expandable Preview Drawer (
v0.8.9–v0.8.11): Replaced hardcoded dark monospace cards with adaptive light/dark default-collapsed single-line bars, added ArtifactExpand ⌄ / Collapse ⌃, Files-Changed collapse/View-Diff drawer & auto-hiding Mark Reviewed, and upgraded#inChatFileSheetwith native two-detent drag-up expansion (80dvh↔97dvh).
2026-11-18 · v0.7.8–v0.8.8 — Swipe Triage Deck, HLS + WebRTC P2P Video, PWA Gestures / Outbox WAL & Instant Launch
- Zero-Loss Outbox WAL, Zero-Jump Session Open & PWA Gestures (
v0.8.4–v0.8.8): Addeddsh_inflight_outbox_v1write-ahead outbox with45supload timeout and strict anti-mid-upload reload guards; upgradedlite=1bootstrap to silent full 48k-char background hydration +flex-shrink: 0uncrushed cards; shipped full-width bidirectional iOS PWA swipe-back (touch-safe during SSE streams) and heavy-damped 2-stage pull-to-refresh (32pxdeadzone,155pxsync,285pxcache-clearing reload). - Standard HLS Streaming, Zero-Dep WebRTC P2P & Cloud Run Small-Chunk Pipeline (
v0.7.8,v0.8.2–v0.8.3): Upgraded video playback to RFC 8216 HLS (index.m3u8+4s .ts/30fps+ lazyhls.js+ automatic~/.dsh/cache/hlsGC), paired with pure-Node.js WebRTCRTCDataChannelP2P direct streaming,1 MiB / 2 MiB720pfast-preview slices, andfs_abortcancellation; added remote📂 Browse Folder&+ New Workspacecreation plus SW dynamic build rollover. - Swipe Triage Deck,
<100msPost-Upgrade Launch & Native iOS PNG Icons (v0.8.0–v0.8.1): Added gesture-driven card-stack triage for approvals, questions & unread conclusions (full zh/en); introduced SW Stale-While-Revalidate App-Shell cache, parallel<head>?lite=1preload (~75% smaller), in-memory Brotli/Gzip, CDN edge self-warming, zero-white-screen deferred upgrades, and full-bleed raster PNG Home Screen icons. - Uninterrupted Code-Reply Voice Playback (
v0.7.9): Added anti-GC utterance pinning, CommonMark §4.5 code-fence parsing, andWakeLockwith📖 Fulldefault mode for uninterrupted long-reply listening.
2026-11-17 · v0.7.5–v0.7.7 — Voice Accuracy Overhaul, High-Signal Push De-Noising, Long-Press Image Save & Draft Isolation
- Self-Healing Sent Draft Cleanup (
v0.7.7): AddedlastSentComposerGuardandreconcileDeliveredComposerDraftto prevent iOS IME ghost commits and 5GLoad faileddrops from restoring already-sent text into the input box. - Clean Artifact Chips, Long-Press Image Save & Per-Session Image Drafts (
v0.7.6): Deduplicated custom Antigravity.mddeliverable blocks and fixed flex ellipsis; enabled450mslong-press native Save/Share in iOS Standalone PWAs without highlighting📎 Quote; scoped unsent image attachments strictly persessionId. - Native Voice Accuracy & iPhone / Feishu Push De-Noising (
v0.7.5): Waited for neuralisFinalhomophone rescoring instead of cutting off at380ms, added LCS de-duplication &25mspause restart; introduced shared zero-LLMpush-formatter.jsstripping Markdown/paths/filler, suppressing subagents, and debouncing1.5stransient approvals.
2026-11-16 · v0.7.4 — 1-Tap Reply Voice Playback (🔊 Listen), Cloud Run Stream Hardening & Multi-Hub Sync
- Zero-Config Algorithmic Reply Voice Playback (
v0.7.4): Added🔊 Listenbeside📋 Copy Replywith< 5msMarkdown-to-speech cleaning,⚡ Summary/📖 Fulltoggle, in-place1x / 1.25x / 1.5xspeed switching, and auto-mute on mic tap. - Cloud Run Tunnel Abort Resilience & Multi-LanguageServer Arbitration (
v0.7.4): PropagatedAbortControllerdisconnects across/api/fs-tunnel, ranked concurrent Antigravity hubs deterministically bylastModifiedTime, and serialized CI release workflows.
2026-11-15 · v0.7.3 — Official Marketplace Listing & OIDC Provenance Publishing
- Official
awesome-dsh-pluginListing & OIDC Trusted Publishing (v0.7.3): Listed in the official marketplace catalog withscreenshots.jsonand switched npm publishing to tokenless GitHub Actions OIDC (npm publish --provenance+ SLSA v1 attestation).
2026-11-14 · v0.7.2 — Full-Featured OpenAI Codex Remote Engine (app-server + codex exec)
- Reliable Multi-Turn Codex Messaging, Reasoning Effort & MCP Approvals (
v0.7.2): Added automaticthread/unsubscribe+ stale writer-lock recovery, losslessmergeCodexTranscripts, reasoning-effort switching (High/xHigh), live📋 Planchecklists,Files With Changesdiff cards, and mobile MCP tool approvals.
2026-11-13 · v0.7.1 — Subagent Lifecycle Folding & ChatGPT-Style Unboxed Chat Flow
- Subagent Folding & Unboxed Document Flow (
v0.7.1): Folded Antigravity / DSH / Claude Code subagents inline into parent conversations while filtering orphan subagent chats; removed outer assistant bubble borders for~15%wider mobile reading width.
2026-11-12 · v0.6.8–v0.7.0 — DSH Market Bundle, Adaptive Video Engine, Mobile HTML Live Preview & Doubao Adapter
- 1-Click DSH Market Install & Embedded Local Hub (
v0.7.0): Full DSH>= 0.2.0bundle manifest that auto-starts an embedded local Control Hub on port8788with Wi-Fi QR pairing when no cloud Hub is configured. - 3-Tier Adaptive Video Engine & Zero-Buffering Tunnel (
v0.6.9):< 2msMP4/MOV parser routing direct play, losslessfaststartremux, and hardware H.264 transcode over aTTFB < 100msstreaming tunnel with multi-Range lossless download. - Mobile Interactive HTML Preview, In-Place iOS Video Save & Doubao Adapter (
v0.6.3–v0.6.8): Isolatednull-origin sandbox preview for HTML code blocks/files, in-place Share-Sheet video save, Doubao Desktop observe-only adapter, WeChat-style hold-to-talk voice, andstate_deltaincremental SSE (98%+bandwidth savings).
2026-11-11 · v0.5.6–v0.5.8 — Streaming File Tunnel, 206 Range Video Player, WorkBuddy Auto-Recovery & Mobile Speech
- WorkBuddy Auto-Recovery, Mobile Speech & Zero-Keystroke Approval Idempotency (
v0.5.7–v0.5.8,v0.6.2): Isolatedworkbuddy-cliOAuth credentials, added per-cwdACP process pool auto-recovery + bidirectionalworkbuddy.dbsync, direct mobile speech recognition, and idempotentalreadySettledapproval protection. - Reverse Streaming File Tunnel,
206 RangeVideo & Deep Codex/WorkBuddy Streaming (v0.5.3–v0.5.6): Added/fs/list|read|stream+/api/fs-tunnel, 240s graceful SSE rotation for Cloud Run,inflightCommandszero-flicker sends, and Codexapp-server/ WorkBuddyACPlive streaming.
2026-11-09 · v0.5.0 — Bilingual Console (EN / 中文), Inline Images & File Preview Chips
- Bilingual Web Console: Added automatic browser language detection (
en/zh) plus a 1-tap🌐 EN / 中文switcher in the Login screen, Top Bar, and Settings. - Inline Chat Images & Clickable File Chips: Local images generated by DSH or Antigravity IDE (including
.gemini/antigravity/brain/artifacts andcarouselblocks) render directly inside mobile chat bubbles, and local[file.py](file:///...)links render as 1-tap code/asset preview chips with instant Hub blob caching and daemon fast-flush (<200ms). - DSH Multiple-Choice & Plan Popups: Full mobile support for DSH
ask_user_question(single/multi-select + custom note) andexit_plan_modeplan confirmation cards. - First-Time Onboarding & Cloud Run Resilience: Automatic
~/.dsh/hub-state.jsonfallback when running without Docker, automatic LAN IP substitution forlocalhostQR codes, and statelesshst_...host token auto-recovery across Cloud Run container scaling. - Host Power & Network Telemetry: Settings cards display real-time laptop battery percentage, charging/AC status, low-battery warnings, and Wi-Fi/LAN latency (
rttMs).
2026-11-07 · v0.4.0 — 1-Line Enrollment, Revocable Host Tokens & Screenshot Upload
- Added 15-minute multi-host enrollment codes (
/install.sh), per-host Ed25519 fingerprint pinning & independent token revocation, and mobile camera/photo-library screenshot attachments with client-side Canvas compression.
2026-11-06 · v0.3.0 — Multi-Harness Support (Antigravity, Codex, Claude) & Rust Turbo
- Added unified session discovery and remote control for Antigravity IDE, OpenAI Codex, and Claude Code alongside DSH, powered by the
dsh-turbonative accelerator and bidirectional SSE streaming.
2026-11-05 · v0.2.0 — iOS 16.4+ Lock-Screen Web Push, Host Migration & E2EE Sharing
- Added RFC 8291/8292 zero-dependency Web Push lock-screen notifications, 1-click cross-computer session migration, and AES-256-GCM end-to-end encrypted shareable replay links (
#k=).
Security & Privacy
- Mandatory Password Gate: The Control Hub refuses to start unless
HUB_TOKENis set, and protects login/pairing endpoints with brute-force rate limiting. - Per-Computer Isolated Tokens: Each enrolled computer receives its own token (
hst_...) and Ed25519 device fingerprint. You can revoke any single computer in Settings without affecting other machines. - End-to-End Encrypted Sharing: When you generate a session replay link, encryption happens on your computer using AES-256-GCM; the decryption key stays in the URL
#k=fragment and is never sent to the server. - Transparent Plugin Permissions Disclosure: When installed as a DSH plugin, this package reads local AI coding session directories on your machine (
~/.dsh, Antigravity, Codex, Claude Code, WorkBuddy, Doubao) and streams workspace files only on explicit user preview requests. It contains zero third-party telemetry and zero vendor relay calls — listening locally with token/pairing authentication by default, and connecting outbound only if you explicitly configure your ownFEISHU_HUB_URLor Feishu self-built app credentials.
FAQ
1. I clicked "Approve" on my phone, why didn't Antigravity IDE press confirm on my Mac?
On macOS, open System Settings → Privacy & Security → Accessibility and enable the switch for Terminal / Node (or tap 🚀 Boost Speed → Unlock Accessibility Permission inside the mobile console to pop up the macOS authorization dialog remotely).
2. Why didn't my iPhone receive lock-screen push notifications?
iOS only allows Web Push for web apps added to the Home Screen. Open your Control Hub URL in Safari, tap Share → Add to Home Screen, launch it from your Home Screen icon, and tap Settings → Enable Push.
3. How do I uninstall or stop the background agent on my computer?
Run
./connect-host.sh --uninstall in the repo directory, or unload the LaunchAgent with:launchctl unload ~/Library/LaunchAgents/com.dsh.remotecontrol.plist
4. Why did Tencent WorkBuddy ask for a one-time browser login, or why didn't an already-open Desktop tab refresh live?
• One-time CLI OAuth: WorkBuddy Desktop encrypts its GUI token via OS Keychain, so the daemon isolates a dedicated
workbuddy-cli OAuth credential (workbuddy-cli.info) so neither side logs the other out. On your first mobile prompt (or via node dsh-feishu/daemon.mjs --workbuddy-login), click Authorize once in the browser window opened on your computer.• Desktop session cache: Mobile turns sync directly to
~/.workbuddy/projects/*.jsonl and workbuddy.db. Because WorkBuddy Desktop caches already-opened conversations in memory without watching external file appends, quit and reopen WorkBuddy Desktop (Cmd + Q) when back at your Mac to view mobile turns inside previously opened tabs.
License
Released under the MIT License.


