Skip to content

Synapse

Drive Claude Code, Codex, Kimi, Grok (or anything with a TUI) running on your computer from your phone.

Drive Claude Code, Codex, Kimi, Grok (or anything with a TUI) running on your computer from your phone.

  • Live terminal: ANSI-coloured screen, block cursor, extra-keys bar, fit-to-phone width.
  • Answer from the notification: one-tap Yes / No / Cancel when an agent asks, guarded so a late tap can never answer a different question.
  • Works anywhere: on your LAN, over USB, or through your own Tailscale node built into the app: no VPN app, so it runs next to Mullvad or any other VPN.
  • Private by design: TLS 1.3 with a pinned certificate, a revocable token, pairing stored in the Android Keystore, screenshots blocked by default.

Needs the free Synapse backend on your computer (an Omarchy bar widget plus a small Python bridge): https://github.com/Lwb89dev/synapse

Summary generated by Zapstore from source.

Original description, as the developer published it.

Latest release

Nov 13, 2026

Claimed app No Google servicesSource available · MIT

Uses the camera to scan QR codes for pairing.

Permissions

  • Camera CAMERA Take photos and record video CAMERA
  • Notifications POST_NOTIFICATIONS Send you notifications
  • Always running REQUEST_IGNORE_BATTERY_OPTIMIZATIONS Keep running in the background without limits

Release notes

Changelog

0.3.0 — 2026-11-13

  • See what the agent is doing on the PC, even when Synapse did not start it. Claude Code and Codex running in a plain terminal now appear in the app (and in the bar widget) as view-only mirrors, rendered from their on-disk transcripts: messages, tool calls and the start of their output, live, with working / idle / needs-you state and notifications (Claude Code reports what it is waiting for). Nothing can be typed into a mirror; synapse run is still the way to drive an agent. "mirror": false in config.json disables it. The ids ext-* are reserved for mirrors. The app (this release) shows them wrapped to the phone width, without keys or input box; update the bridge too (synapse is re-linked by install.sh): an old app lists mirrors but offers input boxes that the bridge refuses (HTTP 409).
  • synapse.service now has KillMode=process: restarting or upgrading the bridge no longer kills the agents' tmux sessions (they live in the unit's cgroup). Stopping the bridge leaves them running; synapse kill <id> ends one.

0.2.0 — 2026-11-12

First public release: the Omarchy plugin, the desktop backend and the Android app.

Highlights

  • Omarchy marketplace-ready plugin. The repository root is the plugin (manifest.json, Panel.qml, id io.github.lwb89dev.synapse). Installing the widget installs nothing else: it offers a Set up… button that runs the installer in a visible terminal. install.sh shows its plan and asks first, needs no sudo, touches nothing outside $HOME, and --uninstall / --purge remove everything.
  • Your own Tailscale node on both ends, no VPN app and no daemon. The desktop runs synapse-net (a sandboxed user service) and the Android app embeds the same node (userspace, no VpnService), so it coexists with a system VPN such as Mullvad. TLS stays pinned end to end on top of the tunnel. Only devices of your own account are forwarded.
  • Answer from the notification. One-tap Yes / No / Cancel on (y/n) prompts and Yes-highlighted menus. Every button carries the prompt it was shown for: the bridge refuses it if that prompt is no longer pending ("Already handled, nothing was sent"). Buttons need the phone unlocked; the lock screen shows no prompt text.
  • Signed release APK (this release), built from the tagged commit.

Android app

  • Material You terminal UI: live ANSI-coloured screen, block cursor, extra-keys bar, ❯ prompt, fit-to-phone width.
  • Pairing by QR or link with an explicit confirmation (hosts, port, certificate fingerprint). The pairing is stored encrypted with an Android Keystore key; FLAG_SECURE is on by default (toggle in the menu).
  • Resumes events after being offline (Last-Event-ID), reconnects on network changes, self-heals the tailnet node after 90 s of unreachability, and asks to be exempted from battery optimisation so alerts survive Doze.
  • Races every address in the pairing at once (LAN, USB, tailnet) and shows which one won.

Bridge and widget

  • synapse CLI: run, ls, attach, kill, pair, status, tailnet, revoke, token, claude-hooks.
  • TLS 1.3 only with a pinned self-signed certificate; bearer token that can be revoked instantly (synapse revoke).
  • Bar widget: sessions, red "needs you" badge, bridge switch, tailnet state and sign-in, pairing QR (wiped when closed).

Security

Two audits and 47 automated tests (bridge/test_security.py, Go tests). Highlights: secrets never in argv, token revocation takes effect immediately, per-address connection limits, local API pinned to our own certificate, pairing link never stored in clear text, a per-process secret protecting the phone's loopback forwarder. See SECURITY.md for the model and the known limits (the bridge listens on 0.0.0.0 by default; one token for all devices).

Known limits

  • The APK contains the tailnet library for arm64 only (all current phones; not x86 emulators).
  • Android 10 or newer. The app is sideloaded; there is no store release.
  • Terminal content is a polled capture-pane snapshot (4 Hz), not a raw PTY stream: no mouse.

Verify the APK

synapse-0.2.0.apk is signed with the project's release key. Certificate SHA-256: A9:97:92:9A:9A:5A:3B:AC:2E:2D:36:82:C2:14:38:58:2D:CA:F4:AD:44:BA:69:E0:D1:5E:3A:8A:A9:33:89:8E (apksigner verify --print-certs synapse-0.2.0.apk). The SHA-256 of the file itself is in synapse-0.2.0.apk.sha256.

Comments

Loading comments…

See more

Get Synapse the private way

Updates checked on your device, and every release verified before it installs.