Quickstart

This first workflow demonstrates Splinterm’s central behavior: the graphical window can close while the daemon-owned terminal session continues running.

1. Install Splinterm

Follow Installation from an x86_64 Omarchy/Arch system.

2. Open a new terminal

Use the installed desktop entry or run:

splinterm-xdg-terminal-exec

A commandless launch creates a fresh persistent Lair, one Dojo, and one Splint. A working directory is preserved exactly. If another application supplies a command through the XDG terminal contract, Splinterm preserves its structured argv without rebuilding shell text and creates a transient client-bound Lair instead. That Lair and all its processes disappear when the command exits or the owning Window disconnects. Native splinterm launch -- COMMAND... remains persistent.

3. Leave the work running

Start a recognizable process in the terminal, then close the graphical window. Closing the final tab detaches the client; it does not terminate the daemon-owned Dojo or its running Splints.

4. Return through Recent Dojos

Open the native Dojo picker:

splinterm dojos

Choose the running Dojo. splinterm sessions remains a compatibility alias. In a focused managed Splinterm window, Ctrl+Shift+S opens the same Recent Dojos workflow as trusted application chrome.

To reopen the last locally remembered running Dojo directly:

splinterm reopen

Essential controls

Action	Control
Command palette	Ctrl+Shift+P
Recent Dojos	Ctrl+Shift+S
New horizontal split	Ctrl+Shift+Enter
New vertical split	Ctrl+Shift+\
Move between panes	Ctrl+Shift+Arrow
Cycle tabs	Ctrl+Tab / Ctrl+Shift+Tab
New Dojo tab	Ctrl+Shift+D
Detach active tab	Ctrl+Shift+Q
Toggle tab strip	Ctrl+Shift+B
Search scrollback	Ctrl+Shift+F
Copy / paste	Ctrl+Shift+C / Ctrl+Shift+V (Super+C/V and Ctrl+Insert/Shift+Insert aliases)

The omarchy-tmux profile advertises Ctrl+Shift+C/V first because compositors may reserve Super chords. Super shortcuts work only when the compositor delivers the chord to the Splinterm Window. When Omarchy classifies com.oldjobobo.splinterm as a terminal, it delivers universal copy/paste as Ctrl+Insert/Shift+Insert, which Splinterm accepts while preserving ordinary Ctrl+C terminal interrupt. While viewing historical output, plain Enter returns the focused pane to live output without submitting terminal input.

Detach is not restore

Reopening attaches to processes that are still running. If a Splint has exited, starting it again from saved launch metadata is an explicit restore operation.

The optional omarchy-tmux profile adds Ctrl+Space / Ctrl+B prefixes, trusted searchable Prefix+? key help, Prefix+[ vi copy mode, and Prefix Shift+S/F/V/O for Save, pin toggle, Preview, and Restore of the current Lair. See Configuration and keymaps.

Next, learn the core concepts, read about sessions and persistence, or create complete layouts with Dojo presets.