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 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

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 Prefix+? key help, and Prefix+[ vi copy mode. See Configuration and keymaps.

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