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
SwitchClick in the sidebar, or ⌘⇧. / ⌘⇧,
Rename or deleteRight-click the workspace
SidebarClick 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.

Switching workspaces swaps the whole tab set

Tabs

New / close⌘T / ⌘W
Go to⌘1 to ⌘9, ⌘⇧] next, ⌘⇧[ previous
RenameDouble-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.

Split panes and windows, then drag them around

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.

Find a file with ⌘P. The viewer reloads when an agent edits 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