How tintinworkstation/mesh works
MESH is a forensic networking suite: analysts use an Android client and desktop tooling to connect to mobile devices over an encrypted overlay, while operators configure networks and access keys through a web control plane. The Android path shown here runs from app/UI state through a local API into the libtailscale engine; the control-plane UI manages networks, policies, and enrollment keys. The README documents relay fallback and optional self-hosted coordination/DERP. Some UI routes and backend implementations are unsampled, so their internal links are omitted or cited only as documented.
Main entry points: App.kt Android app · useNetworks.ts Network management · Client.kt Local API client · client.ts Control API client
Components 29
Android client
- Android app
android-client/android/src/main/java/com/barghest/mesh/App.kt - App screens
android-client/android/src/main/java/com/barghest/mesh/ui/view/MainView.kt - App state
android-client/android/src/main/java/com/barghest/mesh/ui/viewModel/AppViewModel.kt - Local API client
android-client/android/src/main/java/com/barghest/mesh/ui/localapi/Client.kt - IPN models
android-client/android/src/main/java/com/barghest/mesh/ui/model/Ipn.kt - Engine notifications
android-client/android/src/main/java/com/barghest/mesh/ui/notifier/Notifier.kt - Mesh engine
android-client/libtailscale/backend.go - Subnet routing UI
android-client/android/src/main/java/com/barghest/mesh/ui/view/SubnetRoutingView.kt - Subnet routing state
android-client/android/src/main/java/com/barghest/mesh/ui/viewModel/SubnetRoutingViewModel.kt - Android VPN service
Control-plane UI
- Web UI
control-plane/mesh-ui/src/main.tsx - Network management
control-plane/mesh-ui/src/api/useNetworks.ts - Enrollment keys
control-plane/mesh-ui/src/api/usePreAuthKeys.ts - Policy API
control-plane/mesh-ui/src/api/usePolicy.ts - ACL generation
control-plane/mesh-ui/src/lib/aclPolicyGenerator.ts - Control API client
control-plane/mesh-ui/src/api/client.ts
Provisioning service
- Provisioning server
provisioning/cmd/server/main.go - Deployment API
provisioning/internal/api/handler.go - Provisioning admin
provisioning/cmd/admin/main.go - Admin API
provisioning/internal/adminapi/handler.go - Provisioning state
provisioning/internal/state/registry.go
Analyst tooling
- ADB commands
analyst/cmd/adbcollect.go - ADB pairing
analyst/cmd/adbpair.go
Other components
- Forensic analyst
- Operator
- Control-plane API
- Mobile device
- Overlay peer
- DERP relay
Connections 32
- Forensic analyst → Android app: connects device
- Android app → Local API client: uses
android-client/android/src/main/java/com/barghest/mesh/App.kt - Android app → App state: initializes
android-client/android/src/main/java/com/barghest/mesh/App.kt - Android app → Engine notifications: starts
android-client/android/src/main/java/com/barghest/mesh/App.kt - Local API client → Android app: gets engine
android-client/android/src/main/java/com/barghest/mesh/ui/localapi/Client.kt - Local API client → IPN models: transfers state
android-client/android/src/main/java/com/barghest/mesh/ui/localapi/Client.kt - Engine notifications → Mesh engine: watches notifications
android-client/android/src/main/java/com/barghest/mesh/ui/notifier/Notifier.kt - Android app → Mesh engine: initializes engine
android-client/android/src/main/java/com/barghest/mesh/App.kt - Subnet routing UI → Subnet routing state: renders and updates
android-client/android/src/main/java/com/barghest/mesh/ui/view/SubnetRoutingView.kt - Subnet routing state → Local API client: updates preferences
android-client/android/src/main/java/com/barghest/mesh/ui/viewModel/SubnetRoutingViewModel.kt - Operator → Web UI: manages network
- Web UI → Network management: uses management
- Web UI → Enrollment keys: manages enrollment
- Network management → Control API client: sends requests
control-plane/mesh-ui/src/api/useNetworks.ts - Network management → ACL generation: generates policy
control-plane/mesh-ui/src/api/useNetworks.ts - Network management → Policy API: parses policy
control-plane/mesh-ui/src/api/useNetworks.ts - Enrollment keys → Control API client: sends requests
control-plane/mesh-ui/src/api/usePreAuthKeys.ts - Enrollment keys → ACL generation: adds network tag
control-plane/mesh-ui/src/api/usePreAuthKeys.ts - Policy API → Control API client: sends requests
control-plane/mesh-ui/src/api/usePolicy.ts - Control API client → Control-plane API: calls API
- Provisioning server → Deployment API: serves
provisioning/cmd/server/main.go - Provisioning server → Provisioning state: uses state
provisioning/cmd/server/main.go - Provisioning server → Admin API: registers admin API
- Provisioning admin → Admin API: uses
provisioning/cmd/admin/main.go - Admin API → Provisioning state: reads state
provisioning/internal/adminapi/handler.go - Deployment API → Provisioning state: reads state
provisioning/internal/api/handler.go - Forensic analyst → ADB commands: runs acquisition
- ADB commands → Mobile device: collects over ADB
- Forensic analyst → ADB pairing: pairs device
- Android app → Overlay peer: connects encrypted
- Overlay peer → DERP relay: relays if needed
- Android app → Android VPN service: configures VPN