# Terminals Source: https://docs.ideharmony.com/desktop/terminals The terminal is the surface everything else grew around. Rendering is xterm.js; the PTY is owned by the local session host; and the daemon owns durable session state and reattach. That last split is the important one: the window is a view, so closing it detaches rather than terminates. ## Splitting and moving | Action | Shortcut | |---|---| | Split horizontally | Ctrl D | | Split vertically | Ctrl Shift D | | Directional focus | Ctrl ←↑↓→ | | Cycle panes | Ctrl Tab | | Move focus | Ctrl Shift ←↑↓→ | | Maximize pane | Ctrl B then Z | | Reopen closed tab | Ctrl Shift T | On macOS, `mod` shortcuts use ⌘. > [!IMPORTANT] > Ctrl B is a literal tmux-style prefix on **every** > platform, including macOS. While it is armed, global shortcuts are suppressed > — which is why shortcuts sometimes appear dead. Press Esc. A workspace caps at **20 panes**. Past that, terminal rendering and process supervision stop being predictable, so the cap is deliberate rather than arbitrary. ## Working inside a pane | Feature | Notes | |---|---| | In-terminal search | Find text in scrollback | | Context menu | Copy, paste, clear, split | | Vi copy mode | Keyboard selection for vi users | | Line bookmarks | Ctrl M, literal `Ctrl` everywhere | | Scrollback persistence | Survives restart | | Shell integration | Prompt marks for navigation | ## Shell detection and allowlist Harmony detects available shells and launches from an allowlist rather than executing anything named as a shell. Paste handling uses bracketed paste, and PTY output is filtered. > [!SECURITY] > Pasting into a terminal is a classic way to run something you did not read. > Paste warnings exist for that reason — they are not noise. ## Floating panes A pane can be floated out of the split tree when you want it visible alongside another layout rather than inside it. ## Layout presets Layouts can be saved and reapplied from the sidebar picker or the command palette. Worth doing once you find an arrangement that suits a project — it is faster than rebuilding splits each session. ## Crash restore If the UI exits unexpectedly, a restore banner offers to bring panes back, with a progress list that distinguishes a live reattach from a restored/restarted session. > [!NOTE] > Restore reattaches sessions the daemon still holds. It cannot recover a > session that was explicitly stopped, because stopping ends it. ## Verifying what the daemon holds ```powershell harmony sessions list ``` If a pane looks closed in the UI but the process seems alive, this is the authoritative answer. ## Related - [Your first workspace](/docs/getting-started/first-workspace) - [Keyboard shortcuts](/docs/desktop/keyboard-shortcuts) - [Session survival](/docs/concepts/session-survival)