Command line (CLI v2)
Use SARION in your terminal, on your own project files. What it is for, what you need, how to install the signed preview, and how to update or remove it.
Where to find it Capabilities > Terminal (CLI)
What it is
The SARION command line is a terminal client for your SARION account. You run it on your own computer or on a server, inside a project folder. It can read the files you allow, suggest or apply changes, and answer questions about your project. It uses the same account and the same credits as the SARION web app, so there is nothing separate to buy.
This section describes CLI v2, currently a public preview (version 2.0.0-preview.2). A preview can change between versions. Its permissions are explicit: by default it only reads, and anything that changes your files or runs a program needs your approval.
When to use it
Use it when the work is in a folder on your machine: understanding a code base, finding why a test fails, preparing a change, or asking a question about a file. Use the web app for everything else (chat, voice, documents, reports, billing).
What you need
- A SARION account with an active plan and credit. See Billing and credits.
- Node.js 24.21.0 or later within Node 24 (below Node 25), plus npm, Git and Python 3. Check with
node --versionandnpm --version. Node 20, 22 and 25 are not supported by this release. - Linux x64 (Ubuntu 22.04): the program sandbox needs bubblewrap and the
prlimittool from util-linux. - macOS (Intel, macOS 15): supported and tested. Other macOS versions and Apple Silicon are not confirmed.
- Windows: the file tools work, but running programs and Git changes are refused on native Windows. Use WSL2 (Windows Subsystem for Linux) and follow the Linux steps inside it.
- Other processors and systems are not confirmed.
Install on Linux, macOS or WSL2
The installer is a signed package. These commands download it, check its publisher signature, size and checksum against a fingerprint you can compare, and only then install it into its own folder, without administrator rights. Run them in a new, empty working directory:
mkdir sarion-cli-v2-preview &&
cd sarion-cli-v2-preview &&
curl -fL https://github.com/web3devworld/sarion-cli/releases/download/v2.0.0-preview.2/sarion-cli-v2.0.0-preview.2-signed.tar.gz -o sarion-cli-v2.0.0-preview.2-signed.tar.gz &&
mkdir bundle trusted &&
tar -xzf sarion-cli-v2.0.0-preview.2-signed.tar.gz -C bundle &&
curl -fL https://github.com/web3devworld/sarion-cli/releases/download/v2.0.0-preview.2/sarion-cli-release-ed25519-public.pem -o trusted/operator-public.pem &&
git clone https://github.com/web3devworld/sarion-cli.git reviewed-source &&
git -C reviewed-source switch --detach 7c3e855f6d2825494f9e85aca57442c16d773893 &&
node reviewed-source/scripts/verify-release.mjs bundle trusted/operator-public.pem c3c3fc868422444696ca730e3eb2679640682d5cd68521607b7c350a3f93ab40 &&
SARION_RELEASE_PUBLIC_KEY="$PWD/trusted/operator-public.pem" node reviewed-source/scripts/install.mjs bundle "$HOME/.local/share/sarion-cli-v2" &&
export PATH="$HOME/.local/share/sarion-cli-v2/bin:$PATH" &&
sarion --version &&
sarion --help
The check step prints a line that starts with {"verified":true. If it does not, stop: see Troubleshooting the command line. The last two commands should print 2.0.0-preview.2 and the list of commands.
To use sarion in every new terminal, add $HOME/.local/share/sarion-cli-v2/bin to the PATH in your shell's start-up file. The fingerprint in the command (c3c3fc86…) is the official one; the Terminal (CLI) page inside SARION shows the same value, so you can compare them.
Windows
The supported route for running programs and Git changes is WSL2: open an Ubuntu terminal in WSL2, install Node 24, npm, Git and Python 3 there, then use the Linux commands above. A PowerShell installation also exists for the file tools only; its exact commands are on the Terminal (CLI) page inside SARION.
Check that it works
- Run
sarion --version. It prints2.0.0-preview.2. - Run
sarion --help. It lists every command. - Run
sarion sandbox doctor. It reports whether this machine can contain programs safely. It does not need you to sign in.
Next: sign in.
If an older sarion is already installed
The older command-line tool (version 0.x) is a different program. The v2 installer uses its own folder and does not replace it. If typing sarion still opens the older tool, run the v2 program by its full path, ~/.local/share/sarion-cli-v2/bin/sarion --version, or put its folder first in your PATH.
Update
Updates are manual. There is no automatic update and no sarion update command in v2. Stop any running session, download the next signed release, verify it the same way and install it into the same folder. Keep your recovery data when you update.
Remove
- Run
sarion logoutso your sign-in is revoked. - Remove the program:
npm uninstall --global --ignore-scripts --offline --no-audit --no-fund --prefix "$HOME/.local/share/sarion-cli-v2" @volta/sarion-cli.
Removing the program does not sign you out and does not delete recovery data. Do not delete a recovery journal to get past an error.
Common questions
Is the command line available on npm?
No. This version is installed from the signed download above, not with npm install -g.
Does it cost extra?
No. It uses your SARION plan and credit. See Permissions, recovery and credits.
Does it work offline?
No. Every request goes through your SARION account.