ssh-session-open
Open a persistent interactive SSH session with PTY support, automatic idle cleanup, and a terminal dashboard view. Maintain state across commands for remote development and infrastructure workflows.
Instructions
Open a persistent interactive SSH PTY session with automatic idle cleanup and a terminal-style dashboard view.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | Path to a private SSH key on the local machine | |
| cols | No | PTY column count | |
| host | No | SSH host. Falls back to server --host if omitted | |
| port | No | SSH port. Falls back to server --port or 22 | |
| rows | No | PTY row count | |
| term | No | PTY TERM value | |
| user | No | SSH username. Falls back to server --user if omitted | |
| device | No | Device profile id from ssh-session-mcp.config.json | |
| password | No | SSH password | |
| viewerMode | No | Viewer launch mode when autoOpenViewer is enabled | |
| sessionName | No | Optional human-readable alias for the session | |
| startupInput | No | Raw text to send immediately after opening the session | |
| idleTimeoutMs | No | Auto-close the SSH session after this much inactivity. 0 disables idle cleanup | |
| startupWaitMs | No | How long to wait before capturing the initial dashboard | |
| autoOpenViewer | No | Automatically ensure a local viewer is opened for this session | |
| connectionName | No | Logical connection name for the selected device | |
| dashboardWidth | No | Rendered dashboard width in columns | |
| dashboardHeight | No | Rendered dashboard height in rows | |
| includeDashboard | No | Include the rendered dashboard text in the tool response | |
| closedRetentionMs | No | How long to keep a closed session summary/transcript in memory before pruning | |
| startupInputActor | No | Actor label for startupInput, e.g. codex, claude, user | |
| stripAnsiFromLeft | No | Strip ANSI escape sequences from rendered SSH output | |
| dashboardLeftChars | No | How many recent transcript chars to retain in the rendered viewer | |
| dashboardRightEvents | No | How many recent input/control/lifecycle events to retain for actor markers | |
| viewerSingletonScope | No | How viewer singleton deduplication is scoped when autoOpenViewer is enabled |