Installation

The validated installation target is an x86_64 Omarchy system based on Arch Linux. Splinterm is a public alpha, not a supported stable release; upgrades may change interfaces and end daemon-owned shells.

Install the current edge package

Clone the public repository and run the edge installer:

git clone https://github.com/OldJobobo/splinterm.git
cd splinterm
./install.sh

The installer obtains the newest successfully built package for committed main, verifies its manifest and checksums, preserves an emergency binary snapshot, warns before stopping a running daemon, installs through Pacman, and verifies the packaged client identity. The snapshot supports diagnosis and manual recovery; it is not a package-consistent rollback.

The repository, channel manifest, and edge release assets are public. GitHub CLI authentication is optional; the installer falls back to anonymous verified downloads.

Caution

The default installer downloads the newest successfully validated public main edge package. Source mode operates on a clean committed HEAD and does not package uncommitted worktree changes. Review the current worktree before using source mode.

Build from committed source

To compile and package the current committed checkout locally:

./install.sh --source

Include the complete package test suite with:

./install.sh --source --check

What installation does not change

The installer does not:

• make Splinterm your default terminal;
• edit Omarchy or Hyprland configuration;
• enable persistent systemd user lingering; or
• opt a fresh installation into the optional MCP package.

Continue to the quickstart after installation. If an MCP host needs bounded access, follow the separate MCP adapter setup; installing the adapter alone grants no authority.