Features
Workspaces and panes
Workspaces, tabs, panes, windows, drag and drop, files
Workspaces
A workspace is a folder plus its tabs. Switching workspaces swaps the whole tab set. Shells in other workspaces keep running.
| Create | + in the sidebar, pick a folder |
| Switch | Click in the sidebar, or ⌘⇧. / ⌘⇧, |
| Rename or delete | Right-click the workspace |
| Sidebar | Click the divider or press ⌘0 to collapse it to a narrow icon rail. Drag the divider to resize |
"일반" (General) is the workspace without a folder. Its shells start in your home directory, or in working-directory from the config file.
Tabs
| New / close | ⌘T / ⌘W |
| Go to | ⌘1 to ⌘9, ⌘⇧] next, ⌘⇧[ previous |
| Rename | Double-click the tab. A name you set is not overwritten by the shell |
Panes
A tab can be split into panes. Click a pane to focus it, or move focus with ⌘⌥ and an arrow key.
| Split | ⌘D right, ⌘⇧D down |
| Move focus | ⌘⌥← ⌘⌥→ ⌘⌥↑ ⌘⌥↓ |
| Close | ⌘W closes the pane. Closing the last pane closes the tab |
Windows
A workspace can hold several tab bars side by side, each with its own tabs. The app calls them windows: Split Window Right (⌘\) and Split Window Down (⌘⇧\).
To move a tab to another display, put it in a separate macOS window with Move Tab to New Window in the Window menu (⌘⇧N). The tab's right-click menu has the same command, labeled in Korean for now. Closing that macOS window with the red button merges its tabs back into the main window, as does Merge Window into Main. Closing the main window quits the app.
Drag and drop
- Drag a tab to reorder it, to drop it into another window's tab bar, or onto the edge of a window to split.
- Drag a pane by the handle (⋯) at its top edge. It can land next to a pane in another window.
- Drop files from Finder into a terminal to insert escaped absolute paths.
Files
Workspaces with a folder show a file tree under the sidebar. Double-click or press Enter to open a file in a read-only viewer with syntax highlighting and Markdown rendering. ⌘P searches file names. The viewer reloads when the file changes, so you can watch an agent edit it.
Restore
On quit, Deftty saves workspaces, windows, tabs, splits and each pane's directory. On launch it recreates the layout with fresh shells. Claude Code panes get claude --resume prefilled. Scrollback is not restored.
Last updated 2026-09-09, as of Deftty 0.2.6