How playit-cloud/playit-agent works
playit is a game-server tunneling agent, delivered as a background service with a CLI and Windows tray companion. The main operational path is CLI or tray interaction over IPC to the daemon, which manages the agent; the agent maintains control-plane connectivity and forwards TCP/UDP traffic to configured local origins. The README confirms the program’s installable, runnable role, while source-index references support several internal links. Some daemon-to-agent and tray-to-service wiring was not shown, so those links are marked unverified rather than asserted.
Main entry points: playit_agent.rs Agent runtime · main.rs CLI commands · ipc.rs IPC client · daemon.rs Daemon lifecycle
Components 21
User interfaces
- CLI commands
packages/playit-cli/src/main.rs - Service operations
packages/playit-cli/src/client.rs - Service startup
packages/playit-cli/src/service.rs - Terminal UI
packages/playit-cli/src/ui/mod.rs - Status TUI
packages/playit-cli/src/ui/tui_app.rs - Windows tray
packages/playitd-tray/src/windows/frontend.rs
Service and IPC
- Daemon lifecycle
packages/playitd/src/daemon.rs - IPC server
packages/playitd/src/ipc_server.rs - IPC client
packages/playit-ipc/src/ipc.rs - IPC messages
packages/playit-ipc/src/model.rs
Agent runtime
- Agent runtime
packages/agent_core/src/playit_agent.rs - Control lifecycle
packages/agent_core/src/agent_control/maintained_control.rs - Control address selection
packages/agent_core/src/agent_control/address_selector.rs - TCP forwarding
packages/agent_core/src/network/tcp/tcp_clients.rs - UDP forwarding
packages/agent_core/src/network/udp/udp_clients.rs - Local origin lookup
packages/agent_core/src/network/origin_lookup.rs - Tunnel statistics
packages/agent_core/src/stats.rs
Control and networking
- Control messages
packages/agent_proto/src/control_messages.rs - Control feed
packages/agent_proto/src/control_feed.rs - Playit API client
packages/api_client/src/api.rs
Other components
- Operator
Connections 25
- Operator → CLI commands: runs commands
README.md - CLI commands → Service operations: dispatches to
packages/playit-cli/src/main.rs - CLI commands → Terminal UI: presents prompts
packages/playit-cli/src/main.rs - Terminal UI → Status TUI: uses views
packages/playit-cli/src/ui/mod.rs - Service operations → IPC client: sends requests
packages/playit-cli/src/client.rs - CLI commands → Service startup: manages service
packages/playit-cli/src/main.rs - Service startup → Daemon lifecycle: starts or stops
packages/playit-cli/src/service.rs - IPC client → IPC messages: encodes messages
packages/playit-ipc/src/ipc.rs - IPC server → IPC messages: handles messages
- IPC client → IPC server: exchanges IPC
- Windows tray → IPC client: uses IPC
- Daemon lifecycle → IPC server: starts server
packages/playitd/src/daemon.rs - Daemon lifecycle → Agent runtime: runs agent
- Agent runtime → Control lifecycle: maintains control
packages/agent_core/src/playit_agent.rs - Control lifecycle → Control address selection: selects addresses
packages/agent_core/src/agent_control/maintained_control.rs - Control lifecycle → Control messages: uses messages
- Agent runtime → TCP forwarding: runs TCP clients
packages/agent_core/src/playit_agent.rs - Agent runtime → UDP forwarding: runs UDP clients
packages/agent_core/src/playit_agent.rs - Agent runtime → Control feed: consumes feed
- TCP forwarding → Local origin lookup: looks up origins
- UDP forwarding → Local origin lookup: looks up origins
packages/agent_core/src/network/udp/udp_clients.rs - TCP forwarding → Tunnel statistics: updates counters
- UDP forwarding → Tunnel statistics: updates counters
packages/agent_core/src/network/udp/udp_clients.rs - Agent runtime → Tunnel statistics: tracks statistics
packages/agent_core/src/playit_agent.rs - Agent runtime → Playit API client: uses API