CLI reference

The tetherand binary is the host-side reverse-tether driver. Once built (make build) it lives at bin/tetherand in the repo.

tetherand run

The main command. Starts the reverse-tether and blocks until you press Ctrl-C.

tetherand run                       # USB-ADB transport (default)
tetherand run --transport adb       # explicit USB-ADB
tetherand run --transport tcp       # LAN-TCP transport
tetherand run --transport bt        # Bluetooth-RFCOMM
tetherand run --transport aoa       # USB Open Accessory
tetherand run --device <SERIAL>     # target a specific adb device
tetherand run --port 31416          # override the default reverse port

The ADB transport works by running adb reverse localabstract:tetherand tcp:N to bridge the phone's LocalSocket back to a TCP port on the laptop. The relay binds that TCP port and forwards traffic through the host's normal network egress.

tetherand install / uninstall / status

tetherand install                   # installs bin/tetherand.apk
tetherand install --device <SERIAL>
tetherand uninstall                 # removes dev.tetherand.app
tetherand status                    # shows connected devices + version

tetherand tui

Opens a four-panel terminal dashboard:

• TRANSPORTS — which transports are connected.
• TRAFFIC — sparkline of recent rx/tx volume.
• DEVICES — connected adb devices.
• EVENTS — recent connect/disconnect events.

Press q, Q, or Esc to exit.

Convenience wrappers

./connect.sh                        # start tether (uses bin/tetherand if present,
                                    # else falls back to gnirehtet)
./connect.sh --stop                 # tear down
./connect.sh --reinstall            # uninstall + reinstall + relaunch

5364C13D pre-flight scripts

./tutorial.sh                       # browser playbook on http://localhost:7331
./backup.sh                         # local encrypted backup of the phone
./restore.sh                        # restore from backup
./scripts/5364C13D-prep.sh            # pre-conference hardening
./scripts/5364C13D-prep.sh --post     # post-conference attestation diff

Build / release / verification scripts

./scripts/hash-artifacts.sh         # emit SHA-256 + SHA3-256 sidecars
./scripts/bundle-combinations.sh    # emit every native-lib subset zip
./scripts/release-sign.sh           # build + zipalign + apksigner-sign release APK
./scripts/release-upload.sh v0.1    # upload assets to a GitHub release
./scripts/smoke-device.sh           # on-device smoke walk
./scripts/install-launchagent.sh    # install macOS LaunchAgent

The LaunchAgent watches USB attach events for the 5364C13D's vendor:product IDs (0x18d1:0x4ee7 / 0x4ee2 / 0x2d01 / 0x2d00) and auto-fires tetherand run whenever the device is plugged in.

Makefile targets

make build           # cargo build + apk build + hash sidecars
make native-all      # cross-compile all 5 native libs
make native-{wg,tor,nym,pt,rtlsdr}  # individual native libs
make apk             # repackage APK with current jniLibs + emit hashes
make install         # adb install + pre-grant VPN consent
make smoke           # end-to-end test
make smoke-device    # on-device tab walk
make hashes          # regenerate sidecars
make release         # debug-signed release APK
make release-signed  # full release-signing pipeline
make launcher        # install macOS LaunchAgent
make test            # cargo test --workspace
make clean           # cargo + gradle clean + bin/ wipe

Environment variables