Documentation

PARI documentation

PARI is a terminal coding agent. You open a repository, sign in to a model, and ask it to search, edit, and run commands in that project.

Start here

Install the CLI, confirm Python and Bubblewrap, sign in, then start a session in the repository you want changed.

GuideUse it when
InstallYou need to install, update, or remove PARI.
First sessionThe CLI is installed and you want to run a task.
CommandsYou want the flags and the in-session slash commands.
ModelsYou are choosing DeepSeek, OpenAI, Anthropic, Grok, or OpenRouter.
SandboxYou want to know what a command can see and touch.
PermissionsYou want the built-in rules, the ones you write, and the prompt.

What a session does

From the project directory, pari-cli opens a prompt. A normal turn looks like this:

  1. You describe the change in plain language.
  2. PARI searches the repository and reads the files it needs.
  3. It edits files in that workspace.
  4. It runs shell commands inside the Linux Bubblewrap sandbox.
  5. You inspect the diff, undo the last change, or keep going.
cd ~/projects/my-app
pari-cli login
pari-cli

The conversation is stored under .pari/ in that project. Your API key is stored in ~/.pari/auth.json, outside the project.

Where it runs

HostInstall the CLIRun agent commands
LinuxYesYes, with Bubblewrap from /usr/bin or /usr/local/bin.
macOSYesNot yet. Automatic mode refuses to run a command on the Mac host.
WindowsYesUse Ubuntu on WSL2 and install Bubblewrap there. Native Windows does not run commands on the host.

Next