Install CLI
Install the Spirit CLI with the install script, SPIRIT_HOME, and SPIRIT_VERSION.
The CLI is a terminal host with a TUI and a non-interactive -p mode. It talks to the same local daemon as Desktop.
Install script
macOS and Linux:
curl -fsSL https://spirit.dev/install | bashWindows (PowerShell):
irm https://spirit.dev/install.ps1 | iexThe script downloads a build from download.spirit.dev, verifies its SHA-256 against the matching GitHub Release SHA256SUMS.txt (aborting on mismatch), unpacks it, and puts spirit on your PATH.
Open a new terminal, then:
spirit --versionWhere it lands
CLI binaries use SPIRIT_HOME. On Unix, the Stable install and shared data may have the same parent directory; bin/ and cli/ remain installation files. The installer setting does not select the shared-data directory.
| Default | Override | |
|---|---|---|
| CLI binaries | Unix: ~/.spirit · Windows: %LOCALAPPDATA%\Spirit | SPIRIT_HOME |
| Sessions, config, keyring pointers | Stable: ~/.spirit · Dev: ~/.spirit-dev · Windows: %USERPROFILE%\.spirit / %USERPROFILE%\.spirit-dev | SPIRIT_DATA_DIR |
On Unix the script links $SPIRIT_HOME/bin/spirit → $SPIRIT_HOME/cli/current/bin/spirit and appends export PATH="$SPIRIT_HOME/bin:$PATH" to ~/.profile, ~/.bashrc, and ~/.zshrc (marker # spirit cli).
Pin a version or mirror
| Variable | Default | Role |
| ---------------------- | -------------------------------------- | ----------------------------------- | -------- |
| SPIRIT_HOME | ~/.spirit or %LOCALAPPDATA%\Spirit | Install root for CLI binaries |
| SPIRIT_VERSION | latest | Version segment in the download URL |
| SPIRIT_DOWNLOAD_HOST | download.spirit.dev | CDN host |
SPIRIT_VERSION=0.1.0 curl -fsSL https://spirit.dev/install | bashYou can also download a CLI archive from the download page or GitHub Releases and unpack it yourself.
First run
cd /path/to/your/project
spiritThat opens the TUI. Add a provider with /model add, or from the shell with spirit model add. See the quickstart.