Cloud SSH

Cloud SSH is a collaborative terminal room runtime. It lets classic SSH clients and browser clients attach to the same server-side terminal workspace.

The room owns collaboration state. The PTY owns the actual process tree.

flowchart LR
    client["SSH or Web client"]
    room["Collaborative Terminal Room"]
    pty["Real PTY"]
    process["Shell / TUI agent"]

    client --> room
    room --> pty
    pty --> process

Design Principles

• Preserve the classic SSH experience for local terminals.
• Make browser attach a peer view of the same room, not a separate terminal.
• Allow each client to resize, scroll, and inspect through its own view.
• Serialize real PTY input through room authority.
• Keep terminal output in event logs and snapshots, not in CRDT state.

Learning Path

1. Development: run local checks and understand the workspace.
2. Architecture: review the room, PTY, and client-view model.
3. Specs: inspect product and runtime decisions.