Xoral in your terminal

The agent works right in your project folder: reads files, edits code, runs commands and tests, searches the web. It asks before making changes.

Install

macOS and Linux

curl -fsSL https://xoral.si/install | sh

Windows (PowerShell)

irm https://xoral.si/install.ps1 | iex

It installs into .xoral/bin in your home folder and adds itself to PATH. No admin rights needed.

First run

Open a terminal in your project folder and run xoral.
Type /connect, choose Xoral and paste your access key.
Describe the task in plain words, for example: “find out why the test in cart.test.ts fails and fix it”.

You can also set the key with the XORAL_API_KEY environment variable. While Xoral CLI is in closed testing, keys are issued on request at support@xoral.si.

Models

Model	Best for
Xoral Forge	The main one, selected by default: writes and fixes code, digs into errors.
Xoral Spark	Quick answers and small edits.
Xoral Titan	Hard problems: architecture, large changes, reviews. Uses the limit 12× faster.

Switch models with /models.

Useful commands

`xoral`	Open the agent in the current folder
`xoral run "…"`	Run a single task without the interface
`xoral upgrade`	Update Xoral to the latest version
`xoral --help`	All commands

Write project-specific rules for the agent in an AGENTS.md file at the project root.

Xoral CLI is based on OpenCode and distributed under the MIT license.