diff --git a/README.md b/README.md
index 9e987d247..f1febee85 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,20 @@ install the corresponding plugins from the matching repository tag. Run setup ag
installation. Hermes integration requires Hermes Agent v0.20.4 or newer; see the
[Hermes integration guide](integrations/hermes/README.md) for configuration and project-local installation.
+### Pi Coding Agent
+
+With Pi installed, use a PowerContext ref that includes the native Pi package. The following commands use the current
+`master` branch:
+
+```bash
+uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master"
+powercontext setup pi --source oceanbase/powercontext --ref master
+powercontext doctor pi
+```
+
+For a tagged release that includes Pi, replace `master` with the same tag in the first two commands. See
+[Configure Pi](docs/en/docs/how-to/configure-pi.md) for requirements, configuration, and the project-context workflow.
+
### 2. Start and verify the local Server
Keep the Server running in one terminal:
@@ -79,9 +93,9 @@ model.
## Plugins
-PowerContext provides official plugins and installation guides for Codex, Claude Code, DeepSeek Harness, Hermes
-Agent, and Pi. All five integrations use the same scoped data and history-preserving contracts through PowerContext
-Server; the host integrations do not start or embed the Server.
+PowerContext provides official integrations and installation guides for Codex, Claude Code, DeepSeek Harness, Hermes
+Agent, and Pi Coding Agent. All five integrations use the same scoped data and history-preserving contracts through
+PowerContext Server; the host integrations do not start or embed the Server.
### Official integrations
@@ -91,11 +105,13 @@ Server; the host integrations do not start or embed the Server.
 Claude Code |
 DeepSeek Harness |
 Hermes Agent |
+ Pi Coding Agent |
-Pi is provided as a native package; see [Configure Pi](docs/en/docs/how-to/configure-pi.md) for its project-context
-workflow.
+Pi Coding Agent is provided as a native package rather than a host plugin. See
+[Configure Pi](docs/en/docs/how-to/configure-pi.md) for its project-context workflow.
+
## Development
Install the locked development environment and hooks:
diff --git a/README_CN.md b/README_CN.md
index 17569a96a..9784a25d0 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -30,6 +30,19 @@ powercontext setup hermes --source oceanbase/powercontext --ref v0.0.2
Plugin。如需刷新现有安装,请再次运行 setup。Hermes 集成需要 Hermes Agent v0.20.4 或更高版本;配置和项目本地
安装方式详见 [Hermes 集成指南](integrations/hermes/README.md)。
+### Pi Coding Agent
+
+安装 Pi 后,请使用包含原生 Pi package 的 PowerContext 版本。以下命令以当前 `master` 分支为例:
+
+```bash
+uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master"
+powercontext setup pi --source oceanbase/powercontext --ref master
+powercontext doctor pi
+```
+
+如使用包含 Pi 的正式 tag,请在前两条命令中将 `master` 替换为同一 tag。有关依赖、配置和项目上下文工作流,请参阅
+[配置 Pi](docs/zh/docs/how-to/configure-pi.md)。
+
### 2. 启动并验证本地 Server
在一个终端中保持 Server 运行:
@@ -75,8 +88,8 @@ SQLite 数据库。显式 Memory 操作无需配置 inference provider 即可使
## 插件
-PowerContext 为 Codex、Claude Code、DeepSeek Harness 和 Hermes Agent 提供官方插件与安装指南。四个集成都通过
-PowerContext Server 使用同一套作用域数据和保留历史的契约;插件不会自行启动或内嵌 Server。
+PowerContext 为 Codex、Claude Code、DeepSeek Harness、Hermes Agent 和 Pi Coding Agent 提供官方集成与安装指南。
+五种集成都通过 PowerContext Server 使用同一套作用域数据和保留历史的契约;Host 集成不会自行启动或内嵌 Server。
### 官方集成
@@ -86,9 +99,12 @@ PowerContext Server 使用同一套作用域数据和保留历史的契约;插
 Claude Code |
 DeepSeek Harness |
 Hermes Agent |
+ Pi Coding Agent |
+Pi Coding Agent 通过原生 package 而非 Host plugin 接入;详见[配置 Pi](docs/zh/docs/how-to/configure-pi.md)。
+
## 开发
安装锁定的开发环境和 Hook:
diff --git a/README_JP.md b/README_JP.md
index b6e9206a2..e2c5bba89 100644
--- a/README_JP.md
+++ b/README_JP.md
@@ -33,6 +33,20 @@ powercontext setup hermes --source oceanbase/powercontext --ref v0.0.2
再実行してください。Hermes インテグレーションには Hermes Agent v0.20.4 以降が必要です。設定とプロジェクトローカルの
インストール方法については、[Hermes インテグレーションガイド](integrations/hermes/README.md)を参照してください。
+### Pi Coding Agent
+
+Pi をインストールしたうえで、ネイティブ Pi package を含む PowerContext の ref を使用します。以下は現在の
+`master` ブランチを使う例です。
+
+```bash
+uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master"
+powercontext setup pi --source oceanbase/powercontext --ref master
+powercontext doctor pi
+```
+
+Pi を含むリリース tag を使う場合は、最初の 2 つのコマンドの `master` を同じ tag に置き換えてください。必要な
+環境、設定、プロジェクトコンテキストのワークフローは [Configure Pi](docs/en/docs/how-to/configure-pi.md) を参照してください。
+
### 2. ローカル Server を起動して検証する
1 つのターミナルで Server を起動したままにします。
@@ -79,9 +93,9 @@ powercontext doctor codex # または: claude-code / dsh / hermes
## プラグイン
-PowerContext は Codex、Claude Code、DeepSeek Harness、Hermes Agent 向けの公式プラグインとインストールガイドを提供します。
-4 つのインテグレーションはすべて、PowerContext Server を通じて同じスコープ付きデータと履歴を保持する契約を
-使用します。プラグインが Server を自動的に起動したり、組み込んだりすることはありません。
+PowerContext は Codex、Claude Code、DeepSeek Harness、Hermes Agent、Pi Coding Agent 向けの公式インテグレーションと
+インストールガイドを提供します。5 つのインテグレーションはすべて、PowerContext Server を通じて同じスコープ付きデータと
+履歴を保持する契約を使用します。Host インテグレーションが Server を自動的に起動したり、組み込んだりすることはありません。
### 公式インテグレーション
@@ -91,9 +105,13 @@ PowerContext は Codex、Claude Code、DeepSeek Harness、Hermes Agent 向けの
 Claude Code |
 DeepSeek Harness |
 Hermes Agent |
+ Pi Coding Agent |
+Pi Coding Agent は Host plugin ではなくネイティブ package として提供されます。プロジェクトコンテキストのワークフローは
+[Configure Pi](docs/en/docs/how-to/configure-pi.md) を参照してください。
+
## 開発
ロックされた開発環境と Hook をインストールします。