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

# Pi

> Detect and use local pi. The extension only detects. It does not install for you.

Pi uses local `pi`. Auth and models stay in Pi's own directory (usually `~/.pi/`).

Open **Settings → Provider management → CLI** and confirm PI CLI shows **Installed**. The extension does **not** install it for you, and it does not change `auth.json`. In a system terminal, use `pi /login` or add a key from the Pi docs.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/vscode/provider-cli.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=5db25777376fb6428e73b4b9c0ae471e" alt="CLI detection page" width="100%" data-path="images/vscode/provider-cli.png" />

## Install

```bash theme={null}
curl -fsSL https://pi.dev/install.sh | sh
pi --version
```

Alternative:

```bash theme={null}
npm install -g @earendil-works/pi-coding-agent
```

Docs: [https://pi.dev/](https://pi.dev/)

After install, go back to the CLI page and click **Detect again**. If the command is not found, set `PI_BIN` / `PI_PATH` / `PI_CLI_PATH`, or add `~/.pi/bin` to the system `PATH`.

## Capability differences

Compared with Claude Code:

* No plan mode
* MCP / Skills / some settings pages are centered on Claude Code
* Stop ends the `pi` child process
* Chat works, but there is no local history index yet. History does not list Pi sessions

## If detection fails

See [Detect and install](/en/vscode/providers/cli).

## Next steps

* [Provider overview](/en/vscode/providers/overview)
* [Send the first message](/en/vscode/start/first-task)