PowerContext

September 4, 2026 · View on GitHub

为人和 Agent 交接并继续工作而生的上下文。

PyPI version License Apache 2.0 Discord

English · 中文 · 日本語

工作很少会由开始它的人或 Agent 独自完成。你把任务交给 Agent,Agent 推进一部分,之后可能由你或其他人接手。推理过程和当前状态却常常留在那段对话里。

PowerContext 让上下文跟随工作,跨越不同的对话。你回来时,可以看到已经发生了什么,并从当前进展继续。新的 Agent 也能从同一处接手。

你和 Agent 交接工作,并基于已存储的上下文继续推进

官方网站 · 阅读文档

从当前进展继续

你接手时,会先看到当前工作需要的上下文:已经确认的决定、约束、进展、证据和下一步。你可以从这里继续,也可以把工作交给其他人或 Agent,不需要重新翻阅全部记录。

你决定哪些信息以后仍然有用,哪些内容需要随任务交给下一位接手者。PowerContext 把长期信息保存为 Memory,把当前目标和状态组织成 Handoff。你可以把能够复用的做法记录为 Experience 或 Skill。PowerContext 将每项内容限定在对应的工作范围内,并保留它的来源和历史版本。

与你使用的 Agent 一起工作

安装最新发布的 PowerContext

uv tool install "powercontext[cli,server]==0.1.0"

在单独的终端中启动本地 Server:

powercontext server run

0.1.0 发布版不包含 powercontext service 命令。使用 PowerContext 时,请保持 powercontext server run 进程运行;如需使用原生个人服务,请改用下文尚未发布的 master 版本。

Server 默认将上下文保存到本地 SQLite 数据库。

然后从同一个发布版本配置 Agent 集成。例如:

powercontext setup codex --ref powercontext-v0.1.0

PowerContext 工具与 Agent 集成应始终使用同一个 Git ref。如需试用最新但尚未发布的 master,请同时从 master 安装工具和配置集成:

uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master"
powercontext setup codex --source oceanbase/powercontext --ref master

当前 master 还提供可选的持久个人 Server,它可以在终端关闭后继续运行,并在下次登录后再次启动:

powercontext service install # 卸载请运行 `powercontext service uninstall`
powercontext service status

在 Windows 上,未提供登录启动选项时,安装器会询问是否在下次登录时自动启动;直接按 Enter 的默认选择是不启用。 需要显式选择时,请使用 --start-on-login--no-start-on-login

其他 Agent 的配置方式和部署选项请继续阅读 Agent 配置指南。支持的 Agent Client 和 IDE 可通过 MCP 或专用集成连接。

Codex
Codex
Claude Code
Claude Code
DeepSeek Harness
DeepSeek Harness
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 Client、HTTP API、MCP 或进程内 Core SDK 使用 PowerContext。请参考接口说明选择入口。

使用 PowerContext 后有什么变化

PowerContext 在 LoCoMo 和 SWE-bench Pro 上的紧凑对比图

这些对比的评测方法、完整结果和适用边界请见官网评测页

参与构建 PowerContext

make install
make check
make test

完整开发流程请阅读 CONTRIBUTING.md

进一步了解

PowerContext 是 PowerMem 的后续项目。

许可证

PowerContext 基于 Apache License 2.0 发布。