How vbu00/klick works
kl!ck is a Windows and macOS VPN client built around mihomo. Users add a subscription, server link, or configuration; the client presents connection and routing controls, while a privileged service manages VPN state and applies traffic routing. The graph preserves documented subscription, routing, diagnostics, Kill Switch, and tray capabilities, plus the UI-to-service boundary and configuration layer. Some service and platform details are represented at subsystem level because their source was indexed but not excerpted; those links are marked unverified where needed.
Main entry points: engine.rs State engine · main.rs Desktop shell · screens App screens · store.tsx UI state
Components 24
User interface
- App screens
ui/src/screens - UI state
ui/src/lib/store.tsx - UI transport
ui/src/lib/transport.ts - Desktop shell
crates/klick-ui/src/main.rs - Service bridge
crates/klick-ui/src/bridge.rs
Connection and routing
- Connection inputs
crates/klick-core/src/convert.rs - Subscription fetch
crates/klick-service/src/subs.rs - Settings model
crates/klick-core/src/model.rs - Deep links
crates/klick-core/src/deeplink.rs - Routing compiler
crates/klick-core/src/compile.rs
Service runtime
- State engine
crates/klick-service/src/engine.rs - Service entry
crates/klick-service/src/main.rs - Core process
crates/klick-service/src/core.rs - Settings storage
crates/klick-service/src/storage.rs - IP diagnostics
crates/klick-service/src/ipcheck.rs - Kill Switch
crates/klick-service/src/killswitch.rs - Live connections
crates/klick-service/src/neighbors.rs - Network watch
crates/klick-service/src/netwatch.rs
Platform integration
- OS networking
crates/klick-service/src/unix/netconf.rs - Program rules
crates/klick-service/src/programs.rs - Browser proxy
crates/klick-service/src/browsers.rs
Other components
- User
- mihomo
- IP check services
Connections 24
- User → App screens: uses
- App screens → UI state: updates
ui/src/App.tsx - UI state → UI transport: calls
ui/src/lib/store.tsx - UI transport → Desktop shell: invokes
- Desktop shell → Service bridge: starts events
crates/klick-ui/src/main.rs - User → Connection inputs: provides
- Connection inputs → Subscription fetch: fetches subscription
- State engine → Subscription fetch: fetches
crates/klick-service/src/engine.rs - State engine → Settings model: manages
- State engine → Routing compiler: builds config
- State engine → Settings storage: loads and saves
crates/klick-service/src/engine.rs - Service entry → State engine: starts
crates/klick-service/src/main.rs - State engine → Core process: controls
crates/klick-service/src/engine.rs - Routing compiler → mihomo: produces config
crates/klick-core/src/compile.rs - State engine → IP diagnostics: checks IP
crates/klick-service/src/engine.rs - IP diagnostics → IP check services: queries
- State engine → Kill Switch: controls
crates/klick-service/src/engine.rs - State engine → Live connections: queries
crates/klick-service/src/engine.rs - State engine → Network watch: uses
crates/klick-service/src/engine.rs - State engine → OS networking: configures networking
- State engine → Program rules: manages
crates/klick-service/src/engine.rs - State engine → Browser proxy: queries
- User → Deep links: opens link
- Deep links → Desktop shell: opens app