Workspace Panel
Access saved hosts, sessions, pinned commands, and SSH key tools.
Opening the Workspace
The workspace surface holds your saved hosts, sessions list, pinned commands, recent commands, and the SSH key manager. Where it appears depends on the platform:
| Platform | Surface |
|---|---|
| Apple Vision Pro | Opens as its own floating window |
| Mac | Slides in as a sidebar in the active window |
| iPhone | Presents as a sheet from the bottom of the screen |
Open it from the toolbar menu (Menu → Hosts) or via the Command Palette command Open Hosts. Dismiss it with Escape (visionOS / Mac) or by swiping the sheet down (iPhone).
The Sessions list opens through Menu → Sessions, from Hosts → Sessions, or via Open Sessions in the command palette. On Vision Pro it's its own window; on Mac and iPhone it shares the same surface as Hosts.
Saved Hosts
The Hosts section lists your saved server profiles. Each entry shows the host label (or address), connection details, and a status indicator:
- Green dot — currently connected in at least one window or pane
- Empty dot — not connected
Select a host to connect to it (in a new window on visionOS / Mac, or a new pane on iPhone). Use the edit icon next to any host to update its details.
Use + Add Host to save a new server profile, Sessions to open the Sessions surface, or Keys to manage your SSH keys.
For more on saving and editing hosts, see Saved Hosts.
Sessions
The Sessions surface lists sessions in a single flat list sorted by most recent activity.
Each row shows the host label/address, current working directory, and transport badge. Detached sessions (no open window or pane) are marked DETACHED and continue running in the background. An arrow marks the session you're currently viewing.
Select an active session to switch focus to it. Select a detached session to reopen and reattach it.
Use the stop icon at the end of a row to explicitly terminate that session.
Pinned Commands
The Pinned section holds commands you've saved for quick access. Pinned commands can be scoped:
- Global — available in every session
- Host — only shown when connected to a specific server
Select a pinned command to run it. Use the unpin icon to remove it.
Recent Commands
The Recent section shows the last commands you've run in the current session (up to 20). Select any command to run it again, or use the pin icon to save it for later.
SSH Key Manager
Open Keys from the Hosts section to manage your Secure Enclave SSH keys — generate, view, and inspect public keys. For details, see SSH Keys.