### Install pi-acp from Source

Source: https://github.com/svkozak/pi-acp/blob/main/README.md

Installs pi-acp from its source code. This involves cloning the repository, installing dependencies, and building the project.

```bash
npm install
npm run build
```

--------------------------------

### Install and Run Development Dependencies

Source: https://github.com/svkozak/pi-acp/blob/main/README.md

Installs project dependencies and provides commands to run the development server, build the project, lint, and test.

```bash
npm install
npm run dev        # run from src via tsx
npm run build
npm run lint
npm run test
```

--------------------------------

### Install pi-acp Globally

Source: https://github.com/svkozak/pi-acp/blob/main/README.md

Installs the pi-acp package globally using npm. This makes the `pi-acp` command available system-wide.

```bash
npm install -g @earendil-works/pi-coding-agent
```

--------------------------------

### Configure pi-acp Globally Installed in Zed

Source: https://github.com/svkozak/pi-acp/blob/main/README.md

Configures Zed to use a globally installed `pi-acp` command. Ensure `pi-acp` is installed globally via npm.

```json
{
  "agent_servers": {
    "pi": {
      "type": "custom",
      "command": "pi-acp",
      "args": [],
      "env": {}
    }
  }
}
```

--------------------------------

### Authenticate with ACP Registry via Terminal

Source: https://github.com/svkozak/pi-acp/blob/main/README.md

Launches pi in a terminal for interactive login and setup with the ACP Registry. This is used for Terminal Auth.

```bash
pi-acp --terminal-login
```

--------------------------------

### Configure pi-acp with npx in Zed

Source: https://github.com/svkozak/pi-acp/blob/main/README.md

Configures pi-acp in Zed's settings.json using `npx`. This allows using the latest version without a global installation and avoids manual updates.

```json
{
  "agent_servers": {
    "pi": {
      "type": "custom",
      "command": "npx",
      "args": ["-y", "pi-acp"],
      "env": {}
    }
  }
}
```

--------------------------------

### Configure pi-acp from Source in Zed

Source: https://github.com/svkozak/pi-acp/blob/main/README.md

Configures Zed to run the pi-acp adapter from a local build. Point the command to the compiled `dist/index.js` file.

```json
{
  "agent_servers": {
    "pi": {
      "type": "custom",
      "command": "node",
      "args": ["/path/to/pi-acp/dist/index.js"],
      "env": {}
    }
  }
}
```

--------------------------------

### Smoke Test for pi-acp Adapter

Source: https://github.com/svkozak/pi-acp/blob/main/AGENTS.md

This command runs a smoke test for the pi-acp adapter using Node.js. It sends an initialize request to the adapter via stdin and expects a JSON-RPC 2.0 response.

```bash
# Send initialize request via stdin (exact fields depend on ACP SDK version)
# echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1}}' | node dist/index.js
```

--------------------------------

### Enable Embedded Context in pi-acp

Source: https://github.com/svkozak/pi-acp/blob/main/README.md

Sets the `PI_ACP_ENABLE_EMBEDDED_CONTEXT` environment variable to `true`. This advertises ACP `promptCapabilities.embeddedContext` support to the client.

```json
{
  "agent_servers": {
    "pi": {
      "type": "custom",
      "command": "node",
      "args": ["/path/to/pi-acp/dist/index.js"],
      "env": {
          "PI_ACP_ENABLE_EMBEDDED_CONTEXT": "true"
      }
    }
  }
}
```

--------------------------------

### Configure pi-acp via ACP Registry in Zed

Source: https://github.com/svkozak/pi-acp/blob/main/README.md

Adds the pi-acp agent server configuration to Zed's settings.json using the ACP registry. This method automatically keeps the agent configuration up-to-date.

```json
{
  "agent_servers": {
    "pi-acp": {
      "type": "registry"
    }
  }
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.