Get started with SuperTerm

First run

Open a folder, then start a Claude Code session in it. The +button's profile selector lets you pick the shell (PowerShell, bash, cmd) or a CC profile.

• ▸Click Open folder in the toolbar and pick a project directory.
• ▸Use the + profile selector and choose a Claude Code profile to start an agent in that folder.
• ▸Split the pane (right or below) and start a second CC agent to run work in parallel.
• ▸Pin the tab (📌) so the session detaches instead of dying when you close it.

Key concepts

Active vs background sessions

An active session has a visible pane. A background session is a live PTY with no UI — it keeps running and can be reattached. The redesigned model collapses everything into these two states plus a single Sessions surface.

Direct vs persistent

Direct sessions run in-process and die when SuperTerm quits. Persistent sessions are owned by a separate daemon and survive app quit — opt in via Settings → sessionPersistence.enabled.

Reattach & scrollback

Creating a persistent session first tries to reattach an existing one before spawning. Explicit reattach restores the full scrollback buffer; you can also peek a daemon session's buffer read-only without attaching.

Shortcuts & the toolbar

Shortcuts are typed launchers (directory, SSH, webpage, file, tool, dev-workspace, vault, explorer). Promote any of them — or a bare folder — to a colored toolbar button with an icon from the picker.

Panels & layout

Panels dock into a Dockview layout you split, drag, and stack. The layout serializes and restores on launch; Ctrl+Z/Y undoes split/close/move operations.

Keyboard shortcuts

A selection of the defaults — every command is rebindable in Settings → Keybindings, with conflict detection.