diff --git a/README.md b/README.md index b40572dbc..2c61cf56f 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,12 @@ # PowerContext +
+ + + + PowerContext + + **Not only memory** [![PyPI version](https://img.shields.io/pypi/v/powercontext)](https://pypi.org/project/powercontext/) @@ -8,6 +15,8 @@ *[English](README.md) · [中文](README_CN.md) · [日本語](README_JP.md)* +
+ PowerContext is the upgraded version of [PowerMem](https://www.powermem.ai/) and a context runtime for human-agent collaboration. It turns shared work into project context that can be understood, handed off, and continued. @@ -19,24 +28,25 @@ host. ### 1. Install PowerContext and integrations ```bash -uv tool install "powercontext[cli,server]==0.0.2" +uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master" -# Choose one or more integrations. -powercontext setup codex --source oceanbase/powercontext --ref v0.0.2 -powercontext setup claude-code --source oceanbase/powercontext --ref v0.0.2 -powercontext setup dsh --source oceanbase/powercontext --ref v0.0.2 +# Choose one or more integrations. Every setup command installs from the master branch. +powercontext setup codex --source oceanbase/powercontext --ref master +powercontext setup claude-code --source oceanbase/powercontext --ref master +powercontext setup dsh --source oceanbase/powercontext --ref master powercontext setup hermes --source oceanbase/powercontext --ref master - -# OpenClaw and OpenCode currently require the matching CLI and integrations from master. -uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master" powercontext setup openclaw --source oceanbase/powercontext --ref master powercontext setup opencode --source oceanbase/powercontext --ref master +powercontext setup pi --source oceanbase/powercontext --ref master +powercontext setup workbuddy --source oceanbase/powercontext --ref master + +# Or install several hosts in one pass. +powercontext setup select --host codex --host claude-code --host opencode ``` -The first command installs the latest released CLI and local Server in an isolated environment. The release setup -commands install their integrations from the matching repository tag. Until OpenClaw and OpenCode are included in a -release, the extra `uv tool install` command keeps the CLI, Server, and integrations on the same `master` revision. -Run setup again to refresh an existing integration. +The first command installs the CLI and local Server from the latest `master` revision in an isolated environment. +Every setup command installs its integration from the same `master` revision. Run setup again to refresh an existing +integration. ### 2. Start and verify the local Server @@ -50,7 +60,7 @@ In another terminal, verify the service and plugin: ```bash powercontext doctor -powercontext doctor codex # or: claude-code / dsh / hermes / openclaw +powercontext doctor codex # or: claude-code / dsh / hermes / openclaw / opencode / pi / workbuddy ``` By default, the Server listens on `127.0.0.1:8000`, exposes Streamable HTTP MCP at `/mcp`, and persists data in a @@ -85,9 +95,9 @@ model. ## Integrations PowerContext provides official integrations and installation guides for Codex, Claude Code, DeepSeek Harness, Hermes -Agent, LangChain, LangGraph, Pi Coding Agent, OpenClaw, OpenCode, and WorkBuddy. These integrations use the same scoped -data and history-preserving contracts through PowerContext Server; the host integrations do not start or embed the -Server. +Agent, Pi Coding Agent, OpenClaw, OpenCode, WorkBuddy, Bub, Pydantic AI, LangChain, and LangGraph. These 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 @@ -99,13 +109,21 @@ Server. Hermes Agent
Hermes Agent Pi Coding Agent
Pi Coding Agent OpenClaw
OpenClaw + + OpenCode
OpenCode WorkBuddy
WorkBuddy +Bub
Bub +Pydantic AI
Pydantic AI +LangChain
LangChain +LangGraph
LangGraph -Python agent applications can use the [LangChain middleware](docs/en/docs/how-to/configure-langchain.md) or the -[LangGraph node and tools adapter](docs/en/docs/how-to/configure-langgraph.md). +Python agent applications can use the [LangChain middleware](docs/en/docs/how-to/configure-langchain.md), the +[LangGraph node and tools adapter](docs/en/docs/how-to/configure-langgraph.md), the +[Pydantic AI middleware](docs/en/docs/how-to/configure-pydantic-ai.md), or the +[Bub plugin](integrations/bub/README.md). ## Development diff --git a/README_CN.md b/README_CN.md index 26b4b5796..7d4f15791 100644 --- a/README_CN.md +++ b/README_CN.md @@ -1,5 +1,12 @@ # PowerContext +
+ + + + PowerContext + + **不止于记忆** [![PyPI version](https://img.shields.io/pypi/v/powercontext)](https://pypi.org/project/powercontext/) @@ -8,6 +15,8 @@ *[English](README.md) · [中文](README_CN.md) · [日本語](README_JP.md)* +
+ PowerContext 是 [PowerMem](https://www.powermem.ai/) 的升级版本，也是面向人机协作的上下文运行层。它将共同推进的工作沉淀为可理解、可交接、可延续的项目上下文。 ## 快速开始 @@ -17,23 +26,24 @@ PowerContext 是 [PowerMem](https://www.powermem.ai/) 的升级版本，也是 ### 1. 安装 PowerContext 和集成 ```bash -uv tool install "powercontext[cli,server]==0.0.2" +uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master" -# 选择一个或多个集成。 -powercontext setup codex --source oceanbase/powercontext --ref v0.0.2 -powercontext setup claude-code --source oceanbase/powercontext --ref v0.0.2 -powercontext setup dsh --source oceanbase/powercontext --ref v0.0.2 +# 选择一个或多个集成。所有 setup 命令都从 master 分支安装。 +powercontext setup codex --source oceanbase/powercontext --ref master +powercontext setup claude-code --source oceanbase/powercontext --ref master +powercontext setup dsh --source oceanbase/powercontext --ref master powercontext setup hermes --source oceanbase/powercontext --ref master - -# OpenClaw 和 OpenCode 当前需要从 master 安装匹配的 CLI 和集成。 -uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master" powercontext setup openclaw --source oceanbase/powercontext --ref master powercontext setup opencode --source oceanbase/powercontext --ref master +powercontext setup pi --source oceanbase/powercontext --ref master +powercontext setup workbuddy --source oceanbase/powercontext --ref master + +# 或者一次性安装多个 Host。 +powercontext setup select --host codex --host claude-code --host opencode ``` -第一条命令会在隔离环境中安装最新发布的 CLI 和本地 Server；发布版的 setup 命令会从匹配的仓库 tag -安装对应集成。在 OpenClaw 和 OpenCode 进入正式发布版之前，额外的 `uv tool install` 命令会让 CLI、Server -和集成使用同一个 `master` revision。如需刷新现有集成，请再次运行 setup。 +第一条命令会在隔离环境中从最新 `master` revision 安装 CLI 和本地 Server；每条 setup 命令都会从同一个 +`master` revision 安装对应集成。如需刷新现有集成，请再次运行 setup。 ### 2. 启动并验证本地 Server @@ -47,7 +57,7 @@ powercontext server run ```bash powercontext doctor -powercontext doctor codex # or: claude-code / dsh / hermes / openclaw +powercontext doctor codex # 或: claude-code / dsh / hermes / openclaw / opencode / pi / workbuddy ``` 默认情况下，Server 监听 `127.0.0.1:8000`，在 `/mcp` 提供 Streamable HTTP MCP，并将数据持久化到本地 @@ -80,8 +90,8 @@ SQLite 数据库。显式 Memory 操作无需配置 inference provider 即可使 ## 集成 -PowerContext 为 Codex、Claude Code、DeepSeek Harness、Hermes Agent、Pi Coding Agent、OpenClaw、OpenCode 和 -WorkBuddy 提供官方集成与安装指南。 +PowerContext 为 Codex、Claude Code、DeepSeek Harness、Hermes Agent、Pi Coding Agent、OpenClaw、OpenCode、 +WorkBuddy、Bub、Pydantic AI、LangChain 和 LangGraph 提供官方集成与安装指南。 这些集成都通过 PowerContext Server 使用同一套作用域数据和保留历史的契约；宿主集成不会自行启动或内嵌 Server。 ### 官方集成 @@ -94,11 +104,22 @@ WorkBuddy 提供官方集成与安装指南。 Hermes Agent
Hermes Agent Pi Coding Agent
Pi Coding Agent OpenClaw
OpenClaw + + OpenCode
OpenCode WorkBuddy
WorkBuddy +Bub
Bub +Pydantic AI
Pydantic AI +LangChain
LangChain +LangGraph
LangGraph +Python Agent 应用可以使用 [LangChain 中间件](docs/zh/docs/how-to/configure-langchain.md)、 +[LangGraph 节点与工具适配器](docs/zh/docs/how-to/configure-langgraph.md)、 +[Pydantic AI 中间件](docs/zh/docs/how-to/configure-pydantic-ai.md) 或 +[Bub 插件](integrations/bub/README.md)。 + ## 开发 安装锁定的开发环境和 Hook： diff --git a/README_JP.md b/README_JP.md index 021eef4ad..8ea64935b 100644 --- a/README_JP.md +++ b/README_JP.md @@ -1,5 +1,12 @@ # PowerContext +
+ + + + PowerContext + + **記憶を超えて** [![PyPI version](https://img.shields.io/pypi/v/powercontext)](https://pypi.org/project/powercontext/) @@ -8,6 +15,8 @@ *[English](README.md) · [中文](README_CN.md) · [日本語](README_JP.md)* +
+ PowerContext は [PowerMem](https://www.powermem.ai/) のアップグレード版であり、人と Agent の協働を支える コンテキストランタイムです。共同で進めた作業を、理解・引き継ぎ・継続が可能なプロジェクトコンテキストとして 蓄積します。 @@ -19,23 +28,25 @@ macOS または Linux、Python 3.11 以降、[`uv`](https://docs.astral.sh/uv/) ### 1. PowerContext とインテグレーションをインストールする ```bash -uv tool install "powercontext[cli,server]==0.0.2" +uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master" -# 1 つ以上のインテグレーションを選択します。 -powercontext setup codex --source oceanbase/powercontext --ref v0.0.2 -powercontext setup claude-code --source oceanbase/powercontext --ref v0.0.2 -powercontext setup dsh --source oceanbase/powercontext --ref v0.0.2 +# 1 つ以上のインテグレーションを選択します。すべての setup コマンドは master ブランチからインストールします。 +powercontext setup codex --source oceanbase/powercontext --ref master +powercontext setup claude-code --source oceanbase/powercontext --ref master +powercontext setup dsh --source oceanbase/powercontext --ref master powercontext setup hermes --source oceanbase/powercontext --ref master - -# OpenClaw は現在、master から対応する CLI とインテグレーションをインストールする必要があります。 -uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master" powercontext setup openclaw --source oceanbase/powercontext --ref master +powercontext setup opencode --source oceanbase/powercontext --ref master +powercontext setup pi --source oceanbase/powercontext --ref master +powercontext setup workbuddy --source oceanbase/powercontext --ref master + +# 複数の Host を一度にインストールすることもできます。 +powercontext setup select --host codex --host claude-code --host opencode ``` -最初のコマンドは、隔離された環境に最新リリースの CLI とローカル Server をインストールします。リリース版の setup -コマンドは、対応するリポジトリの tag から各インテグレーションをインストールします。OpenClaw がリリースに含まれる -までは、追加の `uv tool install` コマンドによって CLI、Server、インテグレーションを同じ `master` revision に -そろえます。既存のインストールを更新するには、setup をもう一度実行してください。 +最初のコマンドは、隔離された環境に最新の `master` revision から CLI とローカル Server をインストールします。 +各 setup コマンドは、同じ `master` revision から対応するインテグレーションをインストールします。既存の +インストールを更新するには、setup をもう一度実行してください。 ### 2. ローカル Server を起動して検証する @@ -49,7 +60,7 @@ powercontext server run ```bash powercontext doctor -powercontext doctor codex # または: claude-code / dsh / hermes / openclaw +powercontext doctor codex # または: claude-code / dsh / hermes / openclaw / opencode / pi / workbuddy ``` デフォルトでは、Server は `127.0.0.1:8000` で待ち受け、`/mcp` で Streamable HTTP MCP を公開し、 @@ -83,9 +94,10 @@ powercontext doctor codex # または: claude-code / dsh / hermes / openclaw ## インテグレーション -PowerContext は Codex、Claude Code、DeepSeek Harness、Hermes Agent、Pi Coding Agent、OpenClaw、WorkBuddy 向けの公式インテグレーションと -インストールガイドを提供します。これらのインテグレーションは、PowerContext Server を通じて同じスコープ付きデータと -履歴を保持する契約を使用します。ホストインテグレーションが Server を自動的に起動したり、組み込んだりすることはありません。 +PowerContext は Codex、Claude Code、DeepSeek Harness、Hermes Agent、Pi Coding Agent、OpenClaw、OpenCode、 +WorkBuddy、Bub、Pydantic AI、LangChain、LangGraph 向けの公式インテグレーションとインストールガイドを提供します。 +これらのインテグレーションは、PowerContext Server を通じて同じスコープ付きデータと履歴を保持する契約を使用します。 +ホストインテグレーションが Server を自動的に起動したり、組み込んだりすることはありません。 ### 公式インテグレーション @@ -97,10 +109,22 @@ PowerContext は Codex、Claude Code、DeepSeek Harness、Hermes Agent、Pi Codi Hermes Agent
Hermes Agent Pi Coding Agent
Pi Coding Agent OpenClaw
OpenClaw + + +OpenCode
OpenCode WorkBuddy
WorkBuddy +Bub
Bub +Pydantic AI
Pydantic AI +LangChain
LangChain +LangGraph
LangGraph +Python Agent アプリケーションでは、[LangChain ミドルウェア](docs/en/docs/how-to/configure-langchain.md)、 +[LangGraph ノードとツールアダプター](docs/en/docs/how-to/configure-langgraph.md)、 +[Pydantic AI ミドルウェア](docs/en/docs/how-to/configure-pydantic-ai.md)、 +[Bub プラグイン](integrations/bub/README.md) を利用できます。 + ## 開発 ロックされた開発環境と Hook をインストールします。