Faceclaw SSH transport
The Terminal app's SSH client: a small Go package over golang.org/x/crypto/ssh, bound into the apps with gomobile. It provides text-message channels over SSH:
- exec: run a command on the host, exchanging newline-delimited text
(used for tmux control mode and the tmux session poller; see
app/apps/terminal/tmux-client.ts). - websocket: a WebSocket to an address as seen from the host, through a
direct-tcpipchannel (used to tunnel g2mirror-server's protocol).
Channels to the same host and credentials share one SSH connection, with a
keepalive that fails them promptly when the peer silently disappears. Host
keys are pinned by the app (first connection reports the presented key so
the user can verify its fingerprint). Authentication uses a non-exportable
ECDSA P-256 key held by the platform keystore (Android Keystore/StrongBox,
iOS Secure Enclave; see FaceclawSsh.kt / FaceclawSsh.m) and, if the
server allows it, a password saved encrypted on the phone.
Building
scripts/go-ssh-build.cjs runs gomobile bind (pinned in go.mod's tool
block) from the NativeScript before-prepare hook and stages
faceclaw-ssh.aar / Faceclawssh.xcframework into the local
@faceclaw/kotlin plugin. It needs Go 1.26+ on PATH, plus the Android NDK
(Android) or Xcode (iOS); a content stamp skips rebuilds when the Go sources
haven't changed.
Testing
go test -race ./... runs the transport against an in-process SSH server
(host-key pinning, password and keyboard-interactive auth, key auth through
a fake platform signer, exec framing, the websocket tunnel, connection
sharing and loss).
Keeping it current
x/crypto/ssh is the security boundary against a malicious host or a
man in the middle; update it promptly when advisories appear
(go get golang.org/x/crypto@latest && go mod tidy). A Go panic in any
goroutine terminates the app: the package recovers in the goroutines it
owns, but not inside the library's own.