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/how-to/install-and-run.md
#	docs/en/docs/index.md
#	docs/zh/docs/how-to/install-and-run.md
#	docs/zh/docs/index.md
  • Loading branch information
pi-dal committed Aug 20, 2026
commit 1cdbf3917fef82d308bb70fe123e897cd87dda6d
46 changes: 4 additions & 42 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,53 +10,15 @@ PowerContext gives agents durable, project-scoped context. A later session can r

## Get started

## Install for Codex, DeepSeek Harness, or Pi
Use [Install and run](docs/en/docs/how-to/install-and-run.md) for prerequisites, installation, Server startup, and
verification. Then choose a host integration:

- [Codex quickstart](docs/en/docs/tutorials/codex-quickstart.md) provides a first cross-session Memory workflow.
- [Configure Codex](docs/en/docs/how-to/configure-codex.md) and
[Configure DeepSeek Harness](docs/en/docs/how-to/configure-dsh.md) cover host-specific setup.
- [Configure Pi](docs/en/docs/how-to/configure-pi.md) covers the native package and its project-context workflow.

- macOS or Linux;
- [uv](https://docs.astral.sh/uv/getting-started/installation/);
- Codex CLI, DeepSeek Harness (`dsh`), and/or Pi.

```bash
uv tool install "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master"
powercontext --version
```

Configure each host integration from the same Git ref as the installed tool:

```bash
powercontext setup codex --source oceanbase/powercontext --ref master
powercontext setup dsh --source oceanbase/powercontext --ref master
powercontext setup pi --source oceanbase/powercontext --ref master
```

To use a tested branch or tag, replace every occurrence of `master` with that ref. The selected ref must contain every
integration you install.

Start the local service in a terminal:

```bash
powercontext server run
```

The Server listens on `http://127.0.0.1:8000` by default and stores its SQLite database in the platform-specific user data directory. Keep this process running while using PowerContext. In another terminal, verify the package, Server,
and Codex integration:

```bash
powercontext doctor
powercontext doctor codex
powercontext doctor dsh
powercontext doctor pi
```

Runtime or database failures make the Server not ready. A configured inference failure is reported as degraded without removing the Server from traffic; the separate Codex, DeepSeek Harness, and Pi commands do not affect Server health.

Start a new Codex session after setup. Open `/hooks` once and approve the PowerContext hook if Codex asks for trust.

See the [Codex quickstart](docs/en/docs/tutorials/codex-quickstart.md) for a first cross-session workflow.
For other tasks, start from the [documentation overview](docs/en/docs/index.md).

## Choose an interface

Expand Down
3 changes: 2 additions & 1 deletion docs/en/docs/how-to/install-and-run.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,8 @@ powercontext capabilities
readiness covers the database and each configured inference provider. Runtime or database failures return
`not_ready`; an inference failure returns `degraded` without removing database-backed operations from traffic.
`doctor codex`, `doctor dsh`, and `doctor pi` separately check their optional host CLI and PowerContext integration. The content commands exercise the
public HTTP SDK path.
public HTTP SDK path. `ready` and `capabilities` show the readiness and enabled capabilities of the running service. For complete status definitions and
recovery steps, see [Troubleshoot](troubleshoot.md).

## Update or replace an installation

Expand Down
20 changes: 12 additions & 8 deletions docs/en/docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,20 +5,24 @@ description: Install PowerContext, connect Codex, and choose the right integrati

# PowerContext documentation

PowerContext stores project-scoped context for agents. It runs as a local or remote Server and exposes the same
durable Memory through Codex, Claude Code, DeepSeek Harness, Pi, Python, HTTP, and MCP.
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

- [Install and run](how-to/install-and-run.md): install from Git, start the Server, and update it.
- [Configure Codex](how-to/configure-codex.md): install the plugin and control project scope and prompt capture.
- [Configure Claude Code](how-to/configure-claude-code.md): install the plugin and share project Memory with Codex.
- [Configure DeepSeek Harness](how-to/configure-dsh.md): install the DSH plugin and control project scope and prompt capture.
- [Configure Pi](how-to/configure-pi.md): install the native Pi package and control recall, capture, and durable tool writes.
- [Troubleshoot](how-to/troubleshoot.md): diagnose credentials, plugin, Server, database, and hook failures.
- 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

Expand Down
2 changes: 1 addition & 1 deletion docs/zh/docs/how-to/install-and-run.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ powercontext capabilities
`doctor` 检查已安装的包、Server 存活状态和 Server 就绪状态,不要求安装集成。Server 就绪检查涵盖数据库和
每个已配置的推理服务。Runtime 或数据库故障返回 `not_ready`;推理服务故障返回 `degraded`,不会使数据库
操作退出流量。`doctor codex`、`doctor dsh` 和 `doctor pi` 分别检查对应的可选宿主 CLI 与 PowerContext 集成。内容命令会经过公开 HTTP SDK
路径。
路径。`ready` 和 `capabilities` 用于查看运行中服务的就绪状态和已启用能力。完整的状态解释和恢复步骤见[排查问题](troubleshoot.md)。

## 更新或替换安装

Expand Down
19 changes: 11 additions & 8 deletions docs/zh/docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,20 +5,23 @@ description: 安装 PowerContext、连接 Codex,并选择合适的集成方式

# PowerContext 文档

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

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

## 选择你的路径

- [安装和运行](how-to/install-and-run.md):从 Git 安装、启动 Server 和更新版本。
- [配置 Codex](how-to/configure-codex.md):安装插件,并控制项目 scope 和提示词采集。
- [配置 Claude Code](how-to/configure-claude-code.md):安装插件,并与 Codex 共享项目 Memory。
- [配置 DeepSeek Harness](how-to/configure-dsh.md):安装 DSH 插件,并控制项目 scope 和提示词采集。
- [配置 Pi](how-to/configure-pi.md):安装原生 Pi package,并控制召回、采集和持久化工具写入。
- [排查问题](how-to/troubleshoot.md):诊断凭据、插件、Server、数据库和 Hook。
- 想完成一次端到端体验:阅读 [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)。

## 查询细节

Expand Down
You are viewing a condensed version of this merge commit. You can view the full changes here.