Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
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
Prev Previous commit
Next Next commit
Merge remote-tracking branch 'origin/master' into agent/pi-coding-age…
…nt-support

# Conflicts:
#	README.md
#	docs/en/docs/index.md
#	docs/zh/docs/index.md
#	zensical.toml
  • Loading branch information
pi-dal committed Aug 20, 2026
commit 8443ec65a097813e15acdd23f6caf6bc390e7dee
45 changes: 3 additions & 42 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,9 +79,9 @@ model.

## Plugins

PowerContext provides official plugins and installation guides for Codex, Claude Code, DeepSeek Harness, and Pi. All
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 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.

### Official integrations

Expand All @@ -96,45 +96,6 @@ integrations do not start or embed the Server.

Pi is provided as a native package; see [Configure Pi](docs/en/docs/how-to/configure-pi.md) for its project-context
workflow.

## Quick start

You need macOS or Linux, Python 3.11 or newer, [`uv`](https://docs.astral.sh/uv/), and at least one supported host.

### 1. Install PowerContext and the plugins

```bash
uv tool install "powercontext[cli,server]==0.0.2"

# 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
powercontext setup pi --source oceanbase/powercontext --ref v0.0.2
```

The first command installs the CLI and local Server in an isolated environment. The subsequent setup commands
install the corresponding plugins from the matching repository tag. Run setup again to refresh an existing
installation.

### 2. Start and verify the local Server

Keep the Server running in one terminal:

```bash
powercontext server run
```

In another terminal, verify the service and plugin:

```bash
powercontext doctor
powercontext doctor codex # or: claude-code / dsh / pi
```

By default, the Server listens on `127.0.0.1:8000`, exposes Streamable HTTP MCP at `/mcp`, and persists data in a
local SQLite database. Explicit Memory operations work without configuring an inference provider.

## Development

Install the locked development environment and hooks:
Expand Down
29 changes: 3 additions & 26 deletions docs/en/docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,9 @@ overview:
- title: Continue in Claude Code
description: Open the same project Memory from Claude Code and Codex.
href: en/docs/how-to/configure-claude-code/
- title: Continue in Pi
description: Open project context in Pi with the native package.
href: en/docs/how-to/configure-pi/
- title: Hand off current work
description: Prepare a checked Handoff for another task, session, or model.
href: en/docs/how-to/handoff-with-codex/
Expand All @@ -31,29 +34,3 @@ overview:
description: Diagnose connection, configuration, and integration problems.
href: en/docs/how-to/troubleshoot/
---

# PowerContext documentation

PowerContext stores project context that people and agents can use in later tasks. It runs as a local or remote Server
and exposes the same persisted data through Codex, Claude Code, DeepSeek Harness, Pi, Python, HTTP, and MCP.

If this is your first use, start with the [Codex quickstart](tutorials/codex-quickstart.md). When you finish, you can
read and maintain Memory in a later Codex session for the same project.

## Choose your path

- For an end-to-end first experience, read the [Codex quickstart](tutorials/codex-quickstart.md).
- To install, start, update, or relocate a local service, read [Install and run](how-to/install-and-run.md).
- To control project scope, prompt capture, or local authentication, read [Configure Codex](how-to/configure-codex.md).
- To configure another host, read [Configure Claude Code](how-to/configure-claude-code.md) or
[Configure DeepSeek Harness](how-to/configure-dsh.md).
- To configure Pi, read [Configure Pi](how-to/configure-pi.md).
- To understand the boundary between durable Memory and a temporary Handoff, read
[Memory and Handoff](explanation/memory-and-handoff.md).
- To transfer current work to another task, session, or model, read [Hand off work in Codex](how-to/handoff-with-codex.md).
- For installation, Server, plugin, or Hook failures, read [Troubleshoot](how-to/troubleshoot.md).

## Look up details

- [Interfaces](reference/interfaces.md): Codex, Claude Code, DeepSeek Harness, Pi, CLI, Client SDK, Core SDK, HTTP, and MCP.
- [Configuration](reference/configuration.md): defaults and environment variables.
28 changes: 3 additions & 25 deletions docs/zh/docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,9 @@ overview:
- title: 在 Claude Code 中继续
description: 让 Claude Code 和 Codex 打开同一份项目 Memory。
href: zh/docs/how-to/configure-claude-code/
- title: 在 Pi 中继续
description: 通过原生 package 在 Pi 中打开项目上下文。
href: zh/docs/how-to/configure-pi/
- title: 交接当前工作
description: 为另一个任务、会话或模型准备一份经过检查的 Handoff。
href: zh/docs/how-to/handoff-with-codex/
Expand All @@ -31,28 +34,3 @@ overview:
description: 诊断连接、配置和集成问题。
href: zh/docs/how-to/troubleshoot/
---

# PowerContext 文档

PowerContext 保存供人和 Agent 在后续任务中使用的项目上下文。它以本地或远程 Server 的形式运行,并通过 Codex、
Claude Code、DeepSeek Harness、Pi、Python、HTTP 和 MCP 访问同一份持久化数据。

如果这是首次使用,请从 [Codex 快速入门](tutorials/codex-quickstart.md)开始。完成后,你能在同一个项目的后续
Codex 会话中读取并维护 Memory。

## 选择你的路径

- 想完成一次端到端体验:阅读 [Codex 快速入门](tutorials/codex-quickstart.md)。
- 想安装、启动、升级或迁移本地服务:阅读 [安装和运行](how-to/install-and-run.md)。
- 想调整项目 scope、提示词采集或本地鉴权:阅读 [配置 Codex](how-to/configure-codex.md)。
- 想配置其他宿主:阅读 [配置 Claude Code](how-to/configure-claude-code.md) 或
[配置 DeepSeek Harness](how-to/configure-dsh.md)。
- 想配置 Pi:阅读 [配置 Pi](how-to/configure-pi.md)。
- 想理解长期 Memory 与临时 Handoff 的适用边界:阅读[理解 Memory 和 Handoff](explanation/memory-and-handoff.md)。
- 想把当前工作明确移交给另一个任务、会话或模型:阅读 [在 Codex 中交接工作](how-to/handoff-with-codex.md)。
- 遇到安装、Server、插件或 Hook 问题:阅读 [排查问题](how-to/troubleshoot.md)。

## 查询细节

- [接口](reference/interfaces.md):Codex、Claude Code、DeepSeek Harness、Pi、CLI、Client SDK、Core SDK、HTTP 和 MCP。
- [配置](reference/configuration.md):默认值和环境变量。
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,10 @@ export const OPERATIONS = {
get_capabilities: { method: 'GET', path: '/v1/capabilities', location: null, scope: false },
capture_content_source: { method: 'POST', path: '/v1/sources/content', location: "body", scope: true },
prepare_context: { method: 'POST', path: '/v1/context/prepare', location: "body", scope: true },
create_work_contract: { method: 'POST', path: '/v1/work/contracts/create', location: "body", scope: true },
handoff_current_work: { method: 'POST', path: '/v1/work/handoffs/prepare-current', location: "body", scope: true },
acknowledge_handoff: { method: 'POST', path: '/v1/work/handoffs/acknowledge', location: "body", scope: true },
record_task_outcome: { method: 'POST', path: '/v1/work/outcomes/record', location: "body", scope: true },
activate_handoff: { method: 'POST', path: '/v1/handoff/activate', location: "body", scope: true },
prepare_handoff: { method: 'POST', path: '/v1/handoff/prepare', location: "body", scope: true },
finalize_handoff: { method: 'POST', path: '/v1/handoff/finalize', location: "body", scope: true },
Expand Down
64 changes: 38 additions & 26 deletions zensical.toml
Original file line number Diff line number Diff line change
Expand Up @@ -12,19 +12,25 @@ nav = [
{ "English" = [
{ "Home" = "en/index.md" },
{ "Docs" = [
{ "Overview" = "en/docs/index.md" },
{ "Codex quickstart" = "en/docs/tutorials/codex-quickstart.md" },
{ "Install and run" = "en/docs/how-to/install-and-run.md" },
{ "Configure Codex" = "en/docs/how-to/configure-codex.md" },
{ "Memory and Handoff" = "en/docs/explanation/memory-and-handoff.md" },
{ "Hand off work in Codex" = "en/docs/how-to/handoff-with-codex.md" },
{ "Configure Claude Code" = "en/docs/how-to/configure-claude-code.md" },
{ "Configure DeepSeek Harness" = "en/docs/how-to/configure-dsh.md" },
{ "Configure Pi" = "en/docs/how-to/configure-pi.md" },
{ "Troubleshoot" = "en/docs/how-to/troubleshoot.md" },
{ "Trace with Phoenix" = "en/docs/how-to/trace-with-phoenix.md" },
{ "Interfaces" = "en/docs/reference/interfaces.md" },
{ "Configuration" = "en/docs/reference/configuration.md" },
{ "Get started" = [
{ "Overview" = "en/docs/index.md" },
{ "Codex quickstart" = "en/docs/tutorials/codex-quickstart.md" },
{ "Install and run" = "en/docs/how-to/install-and-run.md" },
{ "Memory and Handoff" = "en/docs/explanation/memory-and-handoff.md" },
{ "Hand off work in Codex" = "en/docs/how-to/handoff-with-codex.md" },
{ "Troubleshoot" = "en/docs/how-to/troubleshoot.md" },
] },
{ "Integrations" = [
{ "Configure Codex" = "en/docs/how-to/configure-codex.md" },
{ "Configure Claude Code" = "en/docs/how-to/configure-claude-code.md" },
{ "Configure DeepSeek Harness" = "en/docs/how-to/configure-dsh.md" },
{ "Configure Pi" = "en/docs/how-to/configure-pi.md" },
{ "Trace with Phoenix" = "en/docs/how-to/trace-with-phoenix.md" },
] },
{ "Reference" = [
{ "Interfaces" = "en/docs/reference/interfaces.md" },
{ "Configuration" = "en/docs/reference/configuration.md" },
] },
] },
{ "Development" = [
{ "Core Protocol" = "en/development/core-protocol.md" },
Expand Down Expand Up @@ -70,19 +76,25 @@ nav = [
{ "中文" = [
{ "首页" = "zh/index.md" },
{ "文档" = [
{ "概览" = "zh/docs/index.md" },
{ "Codex 快速入门" = "zh/docs/tutorials/codex-quickstart.md" },
{ "安装和运行" = "zh/docs/how-to/install-and-run.md" },
{ "配置 Codex" = "zh/docs/how-to/configure-codex.md" },
{ "理解 Memory 和 Handoff" = "zh/docs/explanation/memory-and-handoff.md" },
{ "在 Codex 中交接工作" = "zh/docs/how-to/handoff-with-codex.md" },
{ "配置 Claude Code" = "zh/docs/how-to/configure-claude-code.md" },
{ "配置 DeepSeek Harness" = "zh/docs/how-to/configure-dsh.md" },
{ "配置 Pi" = "zh/docs/how-to/configure-pi.md" },
{ "排查问题" = "zh/docs/how-to/troubleshoot.md" },
{ "用 Phoenix 查看 trace" = "zh/docs/how-to/trace-with-phoenix.md" },
{ "接口" = "zh/docs/reference/interfaces.md" },
{ "配置" = "zh/docs/reference/configuration.md" },
{ "开始使用" = [
{ "概览" = "zh/docs/index.md" },
{ "Codex 快速入门" = "zh/docs/tutorials/codex-quickstart.md" },
{ "安装和运行" = "zh/docs/how-to/install-and-run.md" },
{ "理解 Memory 和 Handoff" = "zh/docs/explanation/memory-and-handoff.md" },
{ "在 Codex 中交接工作" = "zh/docs/how-to/handoff-with-codex.md" },
{ "排查问题" = "zh/docs/how-to/troubleshoot.md" },
] },
{ "集成方式" = [
{ "配置 Codex" = "zh/docs/how-to/configure-codex.md" },
{ "配置 Claude Code" = "zh/docs/how-to/configure-claude-code.md" },
{ "配置 DeepSeek Harness" = "zh/docs/how-to/configure-dsh.md" },
{ "配置 Pi" = "zh/docs/how-to/configure-pi.md" },
{ "用 Phoenix 查看 trace" = "zh/docs/how-to/trace-with-phoenix.md" },
] },
{ "参考" = [
{ "接口" = "zh/docs/reference/interfaces.md" },
{ "配置" = "zh/docs/reference/configuration.md" },
] },
] },
{ "开发" = [
{ "Core Protocol" = "zh/development/core-protocol.md" },
Expand Down
Loading
You are viewing a condensed version of this merge commit. You can view the full changes here.