Quickstart

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

1. Install the prerelease

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 Sessions

Open the native session picker:

splinterm sessions

Choose the running Dojo. In a focused managed Splinterm window, Ctrl+Shift+S opens the same Recent Sessions 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 Sessions	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
Search scrollback	Ctrl+Shift+F
Copy / paste	Ctrl+Shift+C / Ctrl+Shift+V

Next, learn the core concepts or read about sessions and persistence.