# jackgeek/climon2 architecture

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

- Interactive diagram: https://gitdiagram.com/jackgeek/climon2
- Repository: https://github.com/jackgeek/climon2

## Overview

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: [`crates/climon2-client/src/transport.rs`](https://github.com/jackgeek/climon2/blob/main/crates/climon2-client/src/transport.rs) (Client transport), [`crates/climon2-daemon/src/session.rs`](https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/session.rs) (Session loop), [`crates/climon2-cli/src/exec.rs`](https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/exec.rs) (Execute command), [`crates/climon2-cli/src/kill.rs`](https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/kill.rs) (Kill session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI commands"]
  node_exec["Execute command<br/>[exec.rs]"]
  node_attach["Attach session<br/>[attach.rs]"]
  node_list["List sessions<br/>[list.rs]"]
  node_kill["Kill session<br/>[kill.rs]"]
end

subgraph group_client["Client runtime"]
  node_bridge["Client bridge<br/>[bridge.rs]"]
  node_transport["Client transport<br/>[transport.rs]"]
end

subgraph group_daemon["Daemon sessions"]
  node_control["Session control<br/>[control.rs]"]
  node_attachments["Attachment control<br/>[attachments.rs]"]
  node_session["Session loop<br/>[session.rs]"]
  node_command["Command lifecycle<br/>[command.rs]"]
  node_delivery["Output delivery<br/>[delivery.rs]"]
end

subgraph group_terminal["Terminal and platform"]
  node_vt["VT state engine<br/>[engine.rs]"]
  node_pty["PTY management<br/>[pty.rs]"]
  node_process["Process lifecycle<br/>[process.rs]"]
end

subgraph group_support["Shared domain"]
  node_protocol["Wire protocol<br/>[protocol.rs]"]
  node_config["Session configuration<br/>[config.rs]"]
  node_selector["Session selection<br/>[selector.rs]"]
  node_installer["Command installer<br/>[command.rs]"]
end

node_user(("Terminal user"))

node_user -->|"runs command"| node_exec
node_user -->|"attaches to"| node_attach
node_user -->|"lists sessions"| node_list
node_user -->|"kills session"| node_kill
node_exec -->|"validates settings"| node_config
node_exec -->|"starts client"| node_bridge
node_attach -->|"starts client"| node_bridge
node_list -.->|"queries daemon"| node_transport
node_kill -->|"resolves session"| node_selector
node_kill -.->|"sends kill"| node_transport
node_bridge -->|"uses transport"| node_transport
node_transport -.->|"encodes frames"| node_protocol
node_transport -.->|"exchanges messages"| node_control
node_control -->|"delegates attachment state"| node_attachments
node_session -->|"observes command"| node_command
node_session -->|"manages delivery"| node_delivery
node_delivery -->|"reads control period"| node_control
node_delivery -->|"requests restoration"| node_vt
node_session -.->|"pumps terminal"| node_pty
node_session -.->|"enforces lifecycle"| node_process
node_exec -.->|"uses installed command"| node_installer
node_user -->|"installs command"| node_installer

click node_exec "https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/exec.rs"
click node_attach "https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/attach.rs"
click node_list "https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/list.rs"
click node_kill "https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/kill.rs"
click node_bridge "https://github.com/jackgeek/climon2/blob/main/crates/climon2-client/src/bridge.rs"
click node_transport "https://github.com/jackgeek/climon2/blob/main/crates/climon2-client/src/transport.rs"
click node_control "https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/control.rs"
click node_attachments "https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/control/attachments.rs"
click node_session "https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/session.rs"
click node_command "https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/session/command.rs"
click node_delivery "https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/session/delivery.rs"
click node_vt "https://github.com/jackgeek/climon2/blob/main/crates/climon2-vt/src/engine.rs"
click node_pty "https://github.com/jackgeek/climon2/blob/main/crates/climon2-platform/src/pty.rs"
click node_process "https://github.com/jackgeek/climon2/blob/main/crates/climon2-platform/src/process.rs"
click node_protocol "https://github.com/jackgeek/climon2/blob/main/crates/climon2-core/src/protocol.rs"
click node_config "https://github.com/jackgeek/climon2/blob/main/crates/climon2-core/src/config.rs"
click node_selector "https://github.com/jackgeek/climon2/blob/main/crates/climon2-core/src/selector.rs"
click node_installer "https://github.com/jackgeek/climon2/blob/main/crates/climon2-install/src/command.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_exec,node_attach,node_list,node_kill,node_user toneBlue
class node_bridge,node_transport toneAmber
class node_control,node_attachments,node_session,node_command,node_delivery toneMint
class node_vt,node_pty,node_process toneRose
class node_protocol,node_config,node_selector,node_installer toneIndigo
```

## Components

### CLI commands

- [Execute command](https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/exec.rs): `crates/climon2-cli/src/exec.rs`
- [Attach session](https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/attach.rs): `crates/climon2-cli/src/attach.rs`
- [List sessions](https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/list.rs): `crates/climon2-cli/src/list.rs`
- [Kill session](https://github.com/jackgeek/climon2/blob/main/crates/climon2-cli/src/kill.rs): `crates/climon2-cli/src/kill.rs`

### Client runtime

- [Client bridge](https://github.com/jackgeek/climon2/blob/main/crates/climon2-client/src/bridge.rs): `crates/climon2-client/src/bridge.rs`
- [Client transport](https://github.com/jackgeek/climon2/blob/main/crates/climon2-client/src/transport.rs): `crates/climon2-client/src/transport.rs`

### Daemon sessions

- [Session control](https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/control.rs): `crates/climon2-daemon/src/control.rs`
- [Attachment control](https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/control/attachments.rs): `crates/climon2-daemon/src/control/attachments.rs`
- [Session loop](https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/session.rs): `crates/climon2-daemon/src/session.rs`
- [Command lifecycle](https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/session/command.rs): `crates/climon2-daemon/src/session/command.rs`
- [Output delivery](https://github.com/jackgeek/climon2/blob/main/crates/climon2-daemon/src/session/delivery.rs): `crates/climon2-daemon/src/session/delivery.rs`

### Terminal and platform

- [VT state engine](https://github.com/jackgeek/climon2/blob/main/crates/climon2-vt/src/engine.rs): `crates/climon2-vt/src/engine.rs`
- [PTY management](https://github.com/jackgeek/climon2/blob/main/crates/climon2-platform/src/pty.rs): `crates/climon2-platform/src/pty.rs`
- [Process lifecycle](https://github.com/jackgeek/climon2/blob/main/crates/climon2-platform/src/process.rs): `crates/climon2-platform/src/process.rs`

### Shared domain

- [Wire protocol](https://github.com/jackgeek/climon2/blob/main/crates/climon2-core/src/protocol.rs): `crates/climon2-core/src/protocol.rs`
- [Session configuration](https://github.com/jackgeek/climon2/blob/main/crates/climon2-core/src/config.rs): `crates/climon2-core/src/config.rs`
- [Session selection](https://github.com/jackgeek/climon2/blob/main/crates/climon2-core/src/selector.rs): `crates/climon2-core/src/selector.rs`
- [Command installer](https://github.com/jackgeek/climon2/blob/main/crates/climon2-install/src/command.rs): `crates/climon2-install/src/command.rs`

### Other components

- **Terminal user**

## Connections

- Terminal user → Execute command: runs command (evidence: `README.md`)
- Terminal user → Attach session: attaches to (evidence: `README.md`)
- Terminal user → List sessions: lists sessions (evidence: `README.md`)
- Terminal user → Kill session: kills session (evidence: `README.md`)
- Execute command → Session configuration: validates settings (evidence: `README.md`)
- Execute command → Client bridge: starts client (evidence: `README.md`)
- Attach session → Client bridge: starts client (evidence: `README.md`)
- List sessions → Client transport: queries daemon
- Kill session → Session selection: resolves session (evidence: `crates/climon2-cli/src/kill.rs`)
- Kill session → Client transport: sends kill
- Client bridge → Client transport: uses transport (evidence: `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 (evidence: `crates/climon2-daemon/src/control.rs`)
- Session loop → Command lifecycle: observes command (evidence: `crates/climon2-daemon/src/session.rs`)
- Session loop → Output delivery: manages delivery (evidence: `crates/climon2-daemon/src/session.rs`)
- Output delivery → Session control: reads control period (evidence: `crates/climon2-daemon/src/session/delivery.rs`)
- Output delivery → VT state engine: requests restoration (evidence: `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 (evidence: `README.md`)
