How gaurav-gosain/tuios works
TUIOS is a terminal multiplexer and window manager. A user launches the CLI, interacts with its modal interface to manage panes and workspaces, and runs shell processes in terminal panes; sessions can persist under the daemon and be reached remotely. The architecture also includes agent-state and Inbox capabilities, configuration, review, tape automation, and a browser server. The README establishes product capabilities; source-index references support several internal dependencies. Unsampled implementation details are represented only where documented, and uncertain links are omitted.
Main entry points: main.go CLI · handler.go Input Routing · window.go Terminal Window · manager.go Session Manager
Components 19
Terminal Interface
- CLI
cmd/tuios/main.go - Input Routing
internal/input/handler.go - Keybind Manager UI
internal/app/render_keybind_manager.go - Keybind Manager
internal/app/keybind_manager.go - Configuration
internal/config/options.go
Pane Runtime
- BSP Layout
internal/layout/bsp.go - Terminal Window
internal/terminal/window.go - Terminal Emulator
internal/vt/handlers.go - Scrollback Parser
internal/scrollback/parser.go
Sessions And Agents
- Session Manager
internal/session/manager.go - Agent Protocol
internal/agentproto/session.go - Worktree Checkpoints
internal/worktree/checkpoint.go
Automation And Access
- Web Terminal Server
cmd/tuios-web/main.go - Dock Engine
internal/app/dock_engine.go - Tape Manager
internal/app/tapemanager.go - Review Commands
cmd/tuios/review_commands.go - Review Engine
internal/review/review.go
Other components
- User
- Pane Shell Process
Connections 19
- User → CLI: launches
- CLI → Input Routing: starts interface
- CLI → Session Manager: manages sessions
- Input Routing → Keybind Manager UI: opens
- Keybind Manager UI → Keybind Manager: uses
- Input Routing → Configuration: routes by bindings
- Input Routing → Terminal Window: routes pane input
internal/input/handler.go - BSP Layout → Configuration: reads settings
internal/layout/bsp.go - Terminal Window → Terminal Emulator: uses emulator
internal/terminal/window.go - Terminal Window → Pane Shell Process: manages PTY process
- Scrollback Parser → Terminal Emulator: parses terminal state
internal/scrollback/parser.go - CLI → Worktree Checkpoints: exposes checkpoint commands
cmd/tuios/main.go - CLI → Review Commands: dispatches review commands
cmd/tuios/main.go - Review Commands → Review Engine: calls
cmd/tuios/review_commands.go - User → Web Terminal Server: connects in browser
- Web Terminal Server → Session Manager: serves TUIOS sessions
- Session Manager → Agent Protocol: tracks agent sessions
- User → Dock Engine: views session rail
- User → Tape Manager: records or replays