Files

core: account identity — same-account devices auto-pair on the LAN

Add an `account` dimension (Apple/Google `sub`, or any shared id) advertised
over mDNS alongside the device name. The LAN transport now connects to a peer
when they share a room OR a non-empty account — so your own devices find each
other and sync on the network regardless of room, no pairing step. Peer gains
`account` so the UI can mark "your devices".

Engine::new gains `account` (6th arg, ""=signed out); all callers updated.
Apps pass "" until sign-in lands; agent takes --account.

Proven by examples/account_pair.rs: two devices in DIFFERENT rooms with the
same account sync over LAN with no server.

Next: derive the account from Sign in with Apple / Google so this is automatic
(the cross-network version = account-derived shared server room).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-21 01:41:00 -05:00

app

core: account identity — same-account devices auto-pair on the LAN

2026-06-21 01:41:00 -05:00

.gitignore

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

build.gradle.kts

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

gradle.properties

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

README.md

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

settings.gradle.kts

android: Compose client scaffold on tethercore (Kotlin/UniFFI)

2026-06-20 23:42:36 -05:00

README.md

tether — Android client

Compose UI over the shared tethercore Rust engine (SSE + RTC) via UniFFI Kotlin bindings. Same engine as the iOS/macOS apps and the desktop agent; only the UI and the binding language differ.

Build (requires the Android NDK)

This machine had no Android toolchain when the app was scaffolded, so the native .so and Kotlin bindings are not committed — they're generated:

Install the toolchain:
- Android Studio (SDK + NDK), or sdkmanager "ndk;26.x"
- cargo install cargo-ndk
- rustup target add aarch64-linux-android x86_64-linux-android
- export ANDROID_NDK_HOME=/path/to/ndk
Generate native libs + bindings:
```
../core/build-android.sh
```
This places libtethercore.so under app/src/main/jniLibs/<abi>/ and the Kotlin binding under app/src/main/java/uniffi/tethercore/.
Build/run the app: open android/ in Android Studio (it generates the Gradle wrapper on first sync), then Run. From the CLI, generate the wrapper once with gradle wrapper, then ./gradlew :app:assembleDebug.

Notes

Default server is http://10.0.2.2:8765 — the emulator's alias for the host machine's localhost. On a physical device use the relay's LAN address.
Android (unlike iOS) lets a foreground app observe clipboard changes, so the app auto-sends via OnPrimaryClipChangedListener. A foreground Service would extend that to the background (future work).
The room id is a per-install UUID (RoomIdentity); account-derived shared rooms are future work, matching the iOS plan.