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

# Pi

> Run OpenRouter-backed Pi coding agents in Replicas workspaces.

Replicas supports [Pi](https://pi.dev) as an SDK-backed coding agent. Pi runs inside the workspace VM, uses OpenRouter for inference, and persists its session and tool history across turns.

## Setup

Pi and Opencode share one OpenRouter API key.

1. Create a key from the [OpenRouter keys page](https://openrouter.ai/keys).
2. Paste it under **Pi → OpenRouter API Key** in [Organization → Coding Agents](https://tryreplicas.com/dashboard/agents). The same credential also appears under **Opencode → OpenRouter API Key**.
3. Set organization credentials for the team, or add a personal key under **Personal** to override the organization default.

See [Credentials](/admin/credentials) for credential scope and fallback behavior.

## Models

Pi and Opencode use the same OpenRouter model catalog:

| Model ID               | Label         | Notes                       |
| ---------------------- | ------------- | --------------------------- |
| `z-ai/glm-5.2`         | GLM 5.2       | Default                     |
| `minimax/minimax-m3`   | MiniMax M3    | Long-context agentic coding |
| `xiaomi/mimo-v2.5-pro` | MiMo V2.5 Pro | Agent-focused Xiaomi model  |
| `moonshotai/kimi-k2.6` | Kimi K2.6     | Multimodal coding model     |

Choose an organization default under [Defaults](/admin/defaults), a personal default in account preferences, or a model for the active chat from the workspace composer.

## Using Pi in Workspaces

Choose **Pi** from the composer's harness/model picker when creating a chat. Pi can:

* Read, write, and edit repository files
* Run shell commands with Replicas command protection
* Accept image attachments
* Persist sessions and tool history across workspace sleep
* Discover provisioned and repository skills through Pi's global `.agents/skills` directory
* Run skills explicitly with `/skill:<name>`

Pi does not currently provide native plan-mode, fast-mode, goal-mode, or environment MCP support. Ask Pi for a read-only implementation plan in the prompt when you want planning without changes.

## Programmatic Use

Select Pi anywhere Replicas accepts a coding agent:

| Surface                              | How to choose Pi                                                      |
| ------------------------------------ | --------------------------------------------------------------------- |
| [CLI](/features/cli)                 | `-a pi` on `replicas create` and `replicas send`                      |
| [API](/features/api)                 | `"coding_agent": "pi"` on create and message requests                 |
| [MCP](/features/mcp)                 | `"coding_agent": "pi"` on `create_replica` and `send_replica_message` |
| [Automations](/features/automations) | Set **Coding agent** to Pi in the automation editor                   |
| [Defaults](/admin/defaults)          | Select Pi as the organization or personal default coding agent        |

```bash theme={null}
replicas create fix-tests \
  -e backend \
  -a pi \
  -m "Inspect the repository and fix the failing tests"
```

```bash theme={null}
curl -X POST "https://api.tryreplicas.com/v1/replica" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "fix-tests",
    "environment_id": "ENVIRONMENT_UUID",
    "message": "Inspect the repository and fix the failing tests",
    "coding_agent": "pi",
    "model": "z-ai/glm-5.2"
  }'
```