Install

01 / 04

scirix-cli is a single static binary. There is no package manager dependency, no runtime, and no daemon. The recommended install path is the one-liner — but every step can be done manually instead.

One-line installers

curl -fsSL https://cli.scirix.fi/install.sh | sh

irm https://cli.scirix.fi/install.ps1 | iex

The script picks the right archive for your OS and architecture (amd64 or arm64), verifies the SHA-256 checksum, and drops the binary into a sensible install dir.

Platform	Default install dir
Linux, macOS	`/usr/local/bin` if writable, otherwise `~/.local/bin`
Windows	`%LOCALAPPDATA%\scirix\bin` (not added to `PATH` unless you opt in)

Pinning a version

Pass --version vX.Y.Z (Linux / macOS) or -Version vX.Y.Z (Windows) to install a specific tag instead of the latest:

curl -fsSL https://cli.scirix.fi/install.sh | sh -s -- --version v1.2.3

irm https://cli.scirix.fi/install.ps1 | iex -Version v1.2.3

Custom install directory

curl -fsSL https://cli.scirix.fi/install.sh | sh -s -- --bin-dir ~/.local/bin

.\install.ps1 -BinDir 'C:\tools\scirix' -AddToPath

Agent skill

scirix-cli is built to be driven by an AI agent. The installer ships an agent skill at ~/.scirix/skills/scirix/ (or %USERPROFILE%\.scirix\skills\scirix\ on Windows) and auto-detects any installed agent — Claude Code, Codex, OpenCode — symlinking the skill into each so they share one source of truth.

Override the autodetection with --agent (or -Agent on Windows):

curl -fsSL https://cli.scirix.fi/install.sh | sh -s -- --agent claude

.\install.ps1 -Agent codex

Values: claude, codex, opencode, all, none. To skip the skill install entirely, pass --no-skill (-NoSkill).

See Usage for what the skill actually does once it's linked.

Agent hooks

Alongside the skill, the installer registers a preprompt hook in each detected agent. Before every user prompt is processed, the hook hands the prompt to scirix, which consults the Reality Model for the active namespace and returns a context bundle for the agent to read alongside the prompt — relevant source-code chunks, linked documentation, neighbouring symbols, and dependency edges that touch the apparent target. The agent starts with that grounding already in context, so it does less Reality-Model querying of its own to get oriented — fewer tool calls, faster first response.

For Claude Code, the hook lands in ~/.claude/settings.json under hooks.UserPromptSubmit. Codex and OpenCode are recognised but skipped for now (no compatible hook protocol on their side yet).

Manage the hooks any time:

scirix hooks install     # register into every detected agent
scirix hooks status      # show which agents have the hook
scirix hooks uninstall   # remove

Upgrading

Once scirix is installed it watches for new releases itself. On every invocation it does a quick check against cli.scirix.fi (24-hour cache, 3-second timeout); when a newer build is published it either prompts you in interactive shells or prints a one-line notice in scripted contexts:

A new version of scirix is available.
Install now? [y/N]:

Type y and the binary downloads, verifies, and installs the update in place. Or run it on demand any time:

scirix update              # install latest
scirix update --version vX.Y.Z   # pin a specific tag

To silence the check entirely (CI runners, locked-down environments), set SCIRIX_NO_UPDATE_CHECK=1 in your environment.

Full option list

The full option list is documented in the script header — fetch it with curl -fsSLO https://cli.scirix.fi/install.sh to read locally before running.

Manual download

Archives are served directly under https://cli.scirix.fi/releases/. The version is in the filename:

https://cli.scirix.fi/releases/scirix-cli_X.Y.Z_linux_amd64.tar.gz
https://cli.scirix.fi/releases/scirix-cli_X.Y.Z_darwin_arm64.tar.gz
https://cli.scirix.fi/releases/scirix-cli_X.Y.Z_windows_amd64.zip

For convenience, the latest build is aliased under /releases/latest/ with the version stripped from both the path and the filename — each URL there redirects to the matching versioned file:

https://cli.scirix.fi/releases/latest/scirix-cli_linux_amd64.tar.gz
https://cli.scirix.fi/releases/latest/scirix-cli_windows_amd64.zip
https://cli.scirix.fi/releases/latest/checksums.txt

Download, extract, drop scirix (or scirix.exe) on your PATH.

Confirm the install

scirix --version

Should print the tag, commit, and build date. If it does, move on to logging in.