Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 21 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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

Expand All @@ -91,11 +105,13 @@ Server; the host integrations do not start or embed the Server.
<td align="center" width="120"><img src="https://github.com/anthropics.png?size=120" alt="Claude Code" width="48" height="48" /><br /><sub><b>Claude Code</b></sub></td>
<td align="center" width="120"><img src="https://github.com/deepseek-ai.png?size=120" alt="DeepSeek Harness" width="48" height="48" /><br /><sub><b>DeepSeek Harness</b></sub></td>
<td align="center" width="120"><a href="integrations/hermes/README.md"><img src="https://github.com/NousResearch/hermes-agent/blob/main/website/static/img/logo.png?raw=true&size=120" alt="Hermes Agent" width="48" height="48" /><br /><sub><b>Hermes Agent</b></sub></a></td>
<td align="center" width="120"><a href="docs/en/docs/how-to/configure-pi.md"><img src="https://github.com/earendil-works.png?size=120" alt="Pi Coding Agent" width="48" height="48" /><br /><sub><b>Pi Coding Agent</b></sub></a></td>
</tr>
</table>

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:
Expand Down
20 changes: 18 additions & 2 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 运行:
Expand Down Expand Up @@ -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。

### 官方集成

Expand All @@ -86,9 +99,12 @@ PowerContext Server 使用同一套作用域数据和保留历史的契约;插
<td align="center" width="120"><img src="https://github.com/anthropics.png?size=120" alt="Claude Code" width="48" height="48" /><br /><sub><b>Claude Code</b></sub></td>
<td align="center" width="120"><img src="https://github.com/deepseek-ai.png?size=120" alt="DeepSeek Harness" width="48" height="48" /><br /><sub><b>DeepSeek Harness</b></sub></td>
<td align="center" width="120"><a href="integrations/hermes/README.md"><img src="https://github.com/NousResearch/hermes-agent/blob/main/website/static/img/logo.png?raw=true&size=120" alt="Hermes Agent" width="48" height="48" /><br /><sub><b>Hermes Agent</b></sub></a></td>
<td align="center" width="120"><a href="docs/zh/docs/how-to/configure-pi.md"><img src="https://github.com/earendil-works.png?size=120" alt="Pi Coding Agent" width="48" height="48" /><br /><sub><b>Pi Coding Agent</b></sub></a></td>
</tr>
</table>

Pi Coding Agent 通过原生 package 而非 Host plugin 接入;详见[配置 Pi](docs/zh/docs/how-to/configure-pi.md)。

## 开发

安装锁定的开发环境和 Hook:
Expand Down
24 changes: 21 additions & 3 deletions README_JP.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 を起動したままにします。
Expand Down Expand Up @@ -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 を自動的に起動したり、組み込んだりすることはありません。

### 公式インテグレーション

Expand All @@ -91,9 +105,13 @@ PowerContext は Codex、Claude Code、DeepSeek Harness、Hermes Agent 向けの
<td align="center" width="120"><img src="https://github.com/anthropics.png?size=120" alt="Claude Code" width="48" height="48" /><br /><sub><b>Claude Code</b></sub></td>
<td align="center" width="120"><img src="https://github.com/deepseek-ai.png?size=120" alt="DeepSeek Harness" width="48" height="48" /><br /><sub><b>DeepSeek Harness</b></sub></td>
<td align="center" width="120"><a href="integrations/hermes/README.md"><img src="https://github.com/NousResearch/hermes-agent/blob/main/website/static/img/logo.png?raw=true&size=120" alt="Hermes Agent" width="48" height="48" /><br /><sub><b>Hermes Agent</b></sub></a></td>
<td align="center" width="120"><a href="docs/en/docs/how-to/configure-pi.md"><img src="https://github.com/earendil-works.png?size=120" alt="Pi Coding Agent" width="48" height="48" /><br /><sub><b>Pi Coding Agent</b></sub></a></td>
</tr>
</table>

Pi Coding Agent は Host plugin ではなくネイティブ package として提供されます。プロジェクトコンテキストのワークフローは
[Configure Pi](docs/en/docs/how-to/configure-pi.md) を参照してください。

## 開発

ロックされた開発環境と Hook をインストールします。
Expand Down
Loading