> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sovara-labs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pi

> Record Pi sessions in Sovara and add relevant lessons to Pi's context.

Requires Node.js 24.22.1 or newer.

1. [Install the Sovara CLI](https://docs.sovara-labs.com/get-started/installation.md) and sign in with
   `sovara login --url <your Sovara URL>`.

2. Install the extension, then start Pi from your project folder:

   ```sh theme={"theme":{"light":"github-light","dark":"github-dark"}}
   pi install npm:@sovara/pi
   pi
   ```

3. Send a message in Pi. In Sovara, open the project matching your folder name.

Sessions are recorded automatically, and relevant lessons are added to Pi's context as you work.
Run `/sovara` in Pi to check the connection, project and recording status, and `/reload` after
installing or changing the connection.

Pi records to the server you signed in to. To use another one, set `SOVARA_SERVER_URL`, or
`execUrl` in `~/.pi/agent/sovara.json`. The project defaults to the folder where you start Pi; to
choose another name, add `.pi/sovara.json`:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{ "projectName": "my-project" }
```

Subagents that Pi starts are recorded as child traces of the turn that started them. Parent and
subagent must use the same `@sovara/pi` version.

To uninstall, run `pi remove npm:@sovara/pi`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.