Skip to content
WearSSH

Phone Companion App

The phone companion app (module wearssh/) is a Jetpack Compose app that mirrors data from the watch — it does not initiate SSH sessions itself.

What syncs from the watch

Section titled “What syncs from the watch”
Data Path Transport
SSH public keys /ssh_key Wear OS Message API
Server list /server_sync Wear OS Data Layer API

Sync is triggered automatically whenever you add or update a server, or send a key, on the watch — there’s no manual “sync now” step.

What you can do on the phone

Section titled “What you can do on the phone”
  • View synced SSH public keys and delete them locally
  • View the synced server list, including favorites and which servers came from the watch (syncedFromWatch)
  • Nothing you do on the phone pushes back to the watch — sync is one-way, watch → phone

Storage

Section titled “Storage”

The phone app keeps its own local Room database (SSHKey, SSHServer tables) separate from the watch’s storage — uninstalling one app does not affect the other’s data.

Under the hood

Section titled “Under the hood”
  • UI: Jetpack Compose, MainViewModel + StateFlow
  • Sync listener: WearListenerService receives Data Layer/Message API events from the watch
  • Storage: Room database, app-private storage only