# stclairc/tuxlink architecture

> Architecture diagram of the GitHub repository stclairc/tuxlink, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/stclairc/tuxlink
- Repository: https://github.com/stclairc/tuxlink

## Overview

Tuxlink is a native Linux desktop client for Winlink emergency communications, combining strategic Winlink messaging with tactical APRS radio operations. Operators enter through the desktop workspace, configure a station, compose or select communications, and send them over CMS, HF, packet, or internet links; APRS also supports local position and chat. Other documented capabilities include forms, station discovery, search, offline maps, FT8 monitoring, WWV decoding, automation routines, and agent control behind operator consent. Source excerpts expose only selected wiring, so documented branches are included without asserting unsampled call relationships.

Main entry points: [`src/App.tsx`](https://github.com/stclairc/tuxlink/blob/main/src/App.tsx) (App workspace), [`src-tauri/src/winlink_backend.rs`](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink_backend.rs) (Winlink B2F), [`src-tauri/src/winlink/mod.rs`](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink/mod.rs) (Radio links), [`src-tauri/src/winlink/aprs/engine.rs`](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink/aprs/engine.rs) (APRS engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop workspace"]
  node_workspace["App workspace<br/>[App.tsx]"]
  node_forms["Forms and composer"]
  node_contacts[("Address book<br/>[store.rs]")]
end

subgraph group_communications["Radio communications"]
  node_mailbox[("Winlink mailbox<br/>[native_mailbox.rs]")]
  node_winlink["Winlink B2F<br/>[winlink_backend.rs]"]
  node_radio_links["Radio links<br/>[mod.rs]"]
  node_aprs["APRS engine<br/>[engine.rs]"]
  node_ax25["AX.25 and UV-Pro<br/>[session.rs]"]
end

subgraph group_station_tools["Station tools"]
  node_catalog[("Station catalog<br/>[stations.rs]")]
  node_station_query["Station finder<br/>[engine.rs]"]
  node_search["Full-text search<br/>[query.rs]"]
  node_maps["Offline maps<br/>[commands.rs]"]
  node_ft8["FT8 monitor<br/>[service.rs]"]
  node_wwv["WWV decoder<br/>[commands.rs]"]
end

subgraph group_automation["Automation and agents"]
  node_routines["Radio routines<br/>[engine.rs]"]
  node_consent["Consent gate<br/>[consent_gate.rs]"]
  node_elmer["Elmer assistant<br/>[commands.rs]"]
  node_mcp["MCP interface<br/>[router.rs]"]
end

subgraph group_platform["Application services"]
  node_config[("Station configuration<br/>[config.rs]")]
end

node_operator(("Operator"))
node_agent(("External MCP agent"))
node_cms(("Winlink CMS"))
node_radio(("Radio and TNC"))

node_operator -->|"operates"| node_workspace
node_workspace -.->|"uses messaging"| node_winlink
node_winlink -.->|"persists messages"| node_mailbox
node_winlink -->|"connects to"| node_cms
node_winlink -->|"uses transports"| node_radio_links
node_radio_links -->|"drives"| node_radio
node_workspace -->|"offers tactical chat"| node_aprs
node_aprs -->|"uses AX.25"| node_ax25
node_ax25 -.->|"transmits frames"| node_radio
node_workspace -->|"composes forms"| node_forms
node_workspace -->|"manages recipients"| node_contacts
node_workspace -->|"browses stations"| node_catalog
node_workspace -->|"finds stations"| node_station_query
node_workspace -->|"searches messages"| node_search
node_workspace -->|"views offline maps"| node_maps
node_workspace -->|"monitors FT8"| node_ft8
node_workspace -->|"decodes WWV"| node_wwv
node_workspace -->|"runs routines"| node_routines
node_routines -->|"requires consent"| node_consent
node_workspace -->|"hosts assistant"| node_elmer
node_agent -->|"issues tools"| node_mcp
node_mcp -.->|"gates operations"| node_consent
node_workspace -.->|"uses settings"| node_config

click node_workspace "https://github.com/stclairc/tuxlink/blob/main/src/App.tsx"
click node_mailbox "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/native_mailbox.rs"
click node_winlink "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink_backend.rs"
click node_radio_links "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink/mod.rs"
click node_aprs "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink/aprs/engine.rs"
click node_ax25 "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink/ax25/uvpro/session.rs"
click node_forms "https://github.com/stclairc/tuxlink/tree/main/src-tauri/src/forms"
click node_contacts "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/contacts/store.rs"
click node_catalog "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/catalog/stations.rs"
click node_station_query "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/station_query/engine.rs"
click node_search "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/search/query.rs"
click node_maps "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/basemap/commands.rs"
click node_ft8 "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/ft8/service.rs"
click node_wwv "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/wwv_offair/commands.rs"
click node_routines "https://github.com/stclairc/tuxlink/blob/main/src-tauri/tuxlink-routines/src/engine.rs"
click node_consent "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/consent_gate.rs"
click node_elmer "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/elmer/commands.rs"
click node_mcp "https://github.com/stclairc/tuxlink/blob/main/src-tauri/tuxlink-mcp-core/src/router.rs"
click node_config "https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/config.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_workspace,node_forms,node_contacts toneBlue
class node_mailbox,node_winlink,node_radio_links,node_aprs,node_ax25 toneAmber
class node_catalog,node_station_query,node_search,node_maps,node_ft8,node_wwv toneMint
class node_routines,node_consent,node_elmer,node_mcp toneRose
class node_config,node_operator,node_agent,node_cms,node_radio toneIndigo
```

## Components

### Desktop workspace

- [App workspace](https://github.com/stclairc/tuxlink/blob/main/src/App.tsx): `src/App.tsx`
- [Forms and composer](https://github.com/stclairc/tuxlink/tree/main/src-tauri/src/forms): `src-tauri/src/forms`
- [Address book](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/contacts/store.rs): `src-tauri/src/contacts/store.rs`

### Radio communications

- [Winlink mailbox](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/native_mailbox.rs): `src-tauri/src/native_mailbox.rs`
- [Winlink B2F](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink_backend.rs): `src-tauri/src/winlink_backend.rs`
- [Radio links](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink/mod.rs): `src-tauri/src/winlink/mod.rs`
- [APRS engine](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink/aprs/engine.rs): `src-tauri/src/winlink/aprs/engine.rs`
- [AX.25 and UV-Pro](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/winlink/ax25/uvpro/session.rs): `src-tauri/src/winlink/ax25/uvpro/session.rs`

### Station tools

- [Station catalog](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/catalog/stations.rs): `src-tauri/src/catalog/stations.rs`
- [Station finder](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/station_query/engine.rs): `src-tauri/src/station_query/engine.rs`
- [Full-text search](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/search/query.rs): `src-tauri/src/search/query.rs`
- [Offline maps](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/basemap/commands.rs): `src-tauri/src/basemap/commands.rs`
- [FT8 monitor](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/ft8/service.rs): `src-tauri/src/ft8/service.rs`
- [WWV decoder](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/wwv_offair/commands.rs): `src-tauri/src/wwv_offair/commands.rs`

### Automation and agents

- [Radio routines](https://github.com/stclairc/tuxlink/blob/main/src-tauri/tuxlink-routines/src/engine.rs): `src-tauri/tuxlink-routines/src/engine.rs`
- [Consent gate](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/consent_gate.rs): `src-tauri/src/consent_gate.rs`
- [Elmer assistant](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/elmer/commands.rs): `src-tauri/src/elmer/commands.rs`
- [MCP interface](https://github.com/stclairc/tuxlink/blob/main/src-tauri/tuxlink-mcp-core/src/router.rs): `src-tauri/tuxlink-mcp-core/src/router.rs`

### Application services

- [Station configuration](https://github.com/stclairc/tuxlink/blob/main/src-tauri/src/config.rs): `src-tauri/src/config.rs`

### Other components

- **Operator**
- **External MCP agent**
- **Winlink CMS**
- **Radio and TNC**

## Connections

- Operator → App workspace: operates
- App workspace → Winlink B2F: uses messaging
- Winlink B2F → Winlink mailbox: persists messages
- Winlink B2F → Winlink CMS: connects to
- Winlink B2F → Radio links: uses transports
- Radio links → Radio and TNC: drives
- App workspace → APRS engine: offers tactical chat
- APRS engine → AX.25 and UV-Pro: uses AX.25 (evidence: `src-tauri/src/winlink/aprs/engine.rs`)
- AX.25 and UV-Pro → Radio and TNC: transmits frames
- App workspace → Forms and composer: composes forms
- App workspace → Address book: manages recipients
- App workspace → Station catalog: browses stations
- App workspace → Station finder: finds stations
- App workspace → Full-text search: searches messages
- App workspace → Offline maps: views offline maps
- App workspace → FT8 monitor: monitors FT8
- App workspace → WWV decoder: decodes WWV
- App workspace → Radio routines: runs routines
- Radio routines → Consent gate: requires consent
- App workspace → Elmer assistant: hosts assistant
- External MCP agent → MCP interface: issues tools
- MCP interface → Consent gate: gates operations
- App workspace → Station configuration: uses settings
