Install CLI
Install the Spirit Agent 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.fast/install | bashWindows (PowerShell):
irm https://spirit.fast/install.ps1 | iexThe script downloads a build from download.spirit.fast, unpacks it, and puts spirit on your PATH.
Open a new terminal, then:
spirit --versionWhere it lands
The install root is not the Spirit Agent data directory.
| Default | Override | |
|---|---|---|
| CLI binaries | Unix: ~/.spirit · Windows: %LOCALAPPDATA%\Spirit | SPIRIT_HOME |
| Sessions, config, keyring pointers | macOS: ~/Library/Application Support/SpiritAgent · Windows: %APPDATA%\SpiritAgent · Linux: ~/.local/share/SpiritAgent | SPIRIT_AGENT_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-agent 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.fast | CDN host |
SPIRIT_VERSION=0.1.0 curl -fsSL https://spirit.fast/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.