Projects (workspaces)¶
Projects save and restore your complete workspace state—all open windows, tabs, SSH connections, and terminal sessions. This lets you quickly switch between different work contexts without manually reconnecting or repositioning windows.
Saving a Project¶
- Open File > Save Project or press Ctrl+S (Cmd+S on macOS).
- Enter a name and optional description for the project.
- Configure Auto-Reconnect:
- When enabled, opening the project will automatically reconnect all saved SSH sessions.
- When disabled, windows and tabs are restored but you must manually reconnect.
- Click Save.
Projects are stored as .kortty files in ~/.kortty/projects/.
Opening a Project¶
- Open File > Open Project or press Ctrl+O (Cmd+O on macOS).
- Select a
.korttyproject file from the file browser. - The Project Preview dialog appears, showing:
- Number of windows to be restored
- Tabs and connections in each window
- Project metadata (name, description, last modified)
- Click Open to load the project.
What Gets Saved¶
A project captures the complete state of your workspace:
| Component | Details |
|---|---|
| Windows | All open KorTTY windows and their positions/sizes |
| Tabs | All terminal tabs in each window, including split-pane configurations |
| Connections | The saved connection names for each tab |
| Dashboard | Dashboard visibility and divider position |
| Active Tab | Which tab was active in each window |
| Terminal Sessions | Session state including cursor position and scrollback (if supported by the session) |
Note
AI result tabs and tool tabs (managers opened as tabs) are not saved with projects. They remain only in the current session and are lost when you close the tab or open a project.
Auto-Reconnect¶
When Auto-Reconnect is enabled, KorTTY automatically:
- Restores all windows with their saved geometry (position and size)
- Reconnects each SSH tab using the original connection settings
- Restores the active tab and dashboard state
If Auto-Reconnect is disabled, windows and tabs are restored but you must manually reconnect each tab by clicking it or using Reconnect from the context menu.
Project File Storage¶
Projects are stored in ~/.kortty/projects/ as compressed .kortty files. Each project includes:
- Metadata (name, description, creation/modification timestamps)
- Complete window and tab state
- Connection references (by name)
- Dashboard visibility and layout
Use Cases¶
Projects are useful for:
- Context switching — Save a "production systems" project, a "development" project, and a "testing" project; open the one you need
- Team handoffs — Share projects with colleagues to set up identical workspace layouts and connections
- Multi-window layouts — Save a complex setup across multiple monitor windows and restore it instantly
- Session recovery — Quickly restore your last known configuration if the app crashes or you accidentally close tabs