How jackgeek/climon2 works
climon2 is a managed terminal-session product: users execute a command in a PTY-backed session, attach or take control later, list sessions, and kill them. The runtime spans CLI commands, client transport, daemon session/control state, VT capture and restoration, and platform process/terminal operations. README documents the user-facing lifecycle and configuration; sampled source confirms key client, daemon-session, delivery, VT, and platform responsibilities. Several daemon and platform links are documented or only partly sampled, so unsampled internals are not presented as inspected.
Main entry points: transport.rs Client transport · session.rs Session loop · exec.rs Execute command · kill.rs Kill session
Components 19
CLI commands
- Execute command
crates/climon2-cli/src/exec.rs - Attach session
crates/climon2-cli/src/attach.rs - List sessions
crates/climon2-cli/src/list.rs - Kill session
crates/climon2-cli/src/kill.rs
Client runtime
- Client bridge
crates/climon2-client/src/bridge.rs - Client transport
crates/climon2-client/src/transport.rs
Daemon sessions
- Session control
crates/climon2-daemon/src/control.rs - Attachment control
crates/climon2-daemon/src/control/attachments.rs - Session loop
crates/climon2-daemon/src/session.rs - Command lifecycle
crates/climon2-daemon/src/session/command.rs - Output delivery
crates/climon2-daemon/src/session/delivery.rs
Terminal and platform
- VT state engine
crates/climon2-vt/src/engine.rs - PTY management
crates/climon2-platform/src/pty.rs - Process lifecycle
crates/climon2-platform/src/process.rs
Shared domain
- Wire protocol
crates/climon2-core/src/protocol.rs - Session configuration
crates/climon2-core/src/config.rs - Session selection
crates/climon2-core/src/selector.rs - Command installer
crates/climon2-install/src/command.rs
Other components
- Terminal user
Connections 22
- Terminal user → Execute command: runs command
README.md - Terminal user → Attach session: attaches to
README.md - Terminal user → List sessions: lists sessions
README.md - Terminal user → Kill session: kills session
README.md - Execute command → Session configuration: validates settings
README.md - Execute command → Client bridge: starts client
README.md - Attach session → Client bridge: starts client
README.md - List sessions → Client transport: queries daemon
- Kill session → Session selection: resolves session
crates/climon2-cli/src/kill.rs - Kill session → Client transport: sends kill
- Client bridge → Client transport: uses transport
crates/climon2-client/src/bridge.rs - Client transport → Wire protocol: encodes frames
- Client transport → Session control: exchanges messages
- Session control → Attachment control: delegates attachment state
crates/climon2-daemon/src/control.rs - Session loop → Command lifecycle: observes command
crates/climon2-daemon/src/session.rs - Session loop → Output delivery: manages delivery
crates/climon2-daemon/src/session.rs - Output delivery → Session control: reads control period
crates/climon2-daemon/src/session/delivery.rs - Output delivery → VT state engine: requests restoration
crates/climon2-daemon/src/session/delivery.rs - Session loop → PTY management: pumps terminal
- Session loop → Process lifecycle: enforces lifecycle
- Execute command → Command installer: uses installed command
- Terminal user → Command installer: installs command
README.md