Keyboard Shortcuts

Updated June 20, 2026

The shortcut scheme follows a simple model: Cmd works at the gem (project tab) level, Cmd + Ctrl works at the shard (session) level, and Cmd + D / Cmd + Opt handle split panes.

Gems (project tabs)

ShortcutAction
Cmd + TNew gem
Cmd + WClose gem (or the focused pane when split)
Cmd + 1-9Jump to gem by position
Cmd + Shift + ]Next gem
Cmd + Shift + [Previous gem

Shards (sessions within a gem)

ShortcutAction
Cmd + Ctrl + TNew shard
Cmd + Ctrl + WClose shard
Cmd + Shift + TResurrect the most recently closed shard (undo-close)
Cmd + Ctrl + 1-9Jump to shard by position
Cmd + Ctrl + ]Next shard
Cmd + Ctrl + [Previous shard

Split panes

ShortcutAction
Cmd + DSplit / unsplit toggle
Cmd + Opt + LeftMove focus to the left pane
Cmd + Opt + RightMove focus to the right pane

Cmd + D changed in v2.75.0. In older versions it made a new shard, now it toggles a split pane. To make a new shard, use Cmd + Ctrl + T.

Terminal

ShortcutAction
Cmd + KClear screen and scrollback (keeps the shell prompt)
Cmd + FFind in scrollback
Cmd + +Increase font size
Cmd + -Decrease font size
Cmd + 0Reset font size
Cmd + Ctrl + FToggle full screen
Cmd + YToggle the chat dock for the focused shard
Cmd + Shift + CCopy selection
Cmd + Shift + VPaste
Cmd + clickOpen a file path or URL under the pointer

Cmd + Y opens a chat-style view of the agent conversation for the focused shard, read from the transcript rather than the terminal renderer — handy for reading and driving the conversation without the TUI.

Cmd + F opens a find bar over the terminal. Type to search, Enter / Shift + Enter jump to the next / previous match, a count shows how many matches were found, and Esc closes the bar.

Cmd + K and Cmd + F are claimed by crystl at the app level (the same way iTerm and Warp claim them), so they won’t reach the program running in the terminal.

Facet inserts

ShortcutAction
Cmd + Opt + 1Fire the facet insert bound to bar slot 1 into the active shard
Cmd + Opt + 2Fire the facet insert bound to bar slot 2
Cmd + Opt + 3Fire the facet insert bound to bar slot 3

Approval management

ShortcutAction
Cmd + EnterAllow current approval
Cmd + DeleteDeny current approval
Cmd + Shift + EnterAllow all queued approvals

App

ShortcutAction
Cmd + ,Open settings
Cmd + QQuit crystl
Hold Option at launchFresh start — open with no restored gems