Terminal (CLI)
Use SARION in your terminal, on your own files. It reads by default and asks before it changes anything.
Where to find it Capabilities > Terminal (CLI)
What it is
The Terminal (CLI) card opens the guide to the SARION command line inside the app. The command line works on your own computer or server, inside a project folder, with your own SARION account. It uses the same plan and the same credits as the rest of SARION.
When to use it
Use it for work on files in a project folder: finding why a test fails, reviewing a patch, answering a question about a file.
Step by step
- Open ⌘ Capabilities and choose Terminal (CLI). The page has the install steps and the fingerprint to compare.
- Install the current version, CLI v2 (public preview 2.0.0-preview.2). The steps are in Command line (CLI v2).
- Run
sarion loginand approve the code in your browser. See Sign in from the command line. - In your project folder run, for example,
sarion agent 'Summarize this project without changing files' --model auto --permission-mode read-only --share-context.
The older tool
An older command-line tool (version 0.x) is still described on the Terminal (CLI) page, under "Legacy guide". It is a separate program with its own commands, such as sarion -p "request" and sarion update. This manual covers CLI v2; the two can be installed side by side, and the v2 guide explains how to tell them apart.
Limits
- CLI v2 is a public preview and can change.
- It uses your SARION credit.
- It cannot run programs or change Git on native Windows. Use WSL2.
Common questions
How do I install the SARION terminal tool?
Open Terminal (CLI) in the Capabilities menu, or follow Command line (CLI v2).
How do I use SARION in my terminal?
Install CLI v2, run sarion login, then run sarion agent or sarion ask in your project folder.
Is the terminal tool free?
It has no separate price. It uses your plan and credit.