PowerContext is the upgraded version of PowerMem and a context runtime for human-agent collaboration. It turns shared work into project context that can be understood, handed off, and continued.
You need macOS or Linux, Python 3.11 or newer, uv, and at least one supported agent
host.
uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@master"
# 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
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 opencodeThe 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.
Keep the Server running in one terminal:
powercontext server runIn another terminal, verify the service and plugin:
powercontext doctor
powercontext doctor codex # or: claude-code / dsh / hermes / openclaw / opencode / pi / workbuddyBy 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.
| Capability | Core value |
|---|---|
| Memory extraction and management | Explicitly record decisions, constraints, outcomes, state, and next steps worth reusing over time; with a generation model configured, Memory can also be extracted from Sources. Revisions and retirements preserve history |
| Bounded request-time recall | Before an agent handles a request, generate one schema-validated, cited PreparedContext based on project scope, relevance, and a byte budget; recall failures do not block the original task |
| Handoff | Organize the objective, verified progress, blockers, next step, and evidence into an inspectable work package so another session, task, model, or agent host can continue from a clear state |
| Sources and evidence lineage | Preserve the original sources of knowledge and link Memory and Artifacts with exact citations; capturing a prompt creates only a Source and does not directly turn it into Memory |
| Experience and Skill governance | A model or caller can only submit a Candidate; an immutable revision is created only after Review, and a Skill must still be exported explicitly—it cannot approve, install, or execute itself |
| Local and service deployment | Use SQLite directly for local development, choose OceanBase for team deployments, and integrate with existing systems through HTTP/OpenAPI, MCP, authentication, and OpenTelemetry |
The evaluation ran in a Codex environment, with both the PowerContext OFF and ON groups using the gpt-5.6-sol
model.
PowerContext provides official integrations and installation guides for Codex, Claude Code, DeepSeek Harness, Hermes 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.
 Codex |
 Claude Code |
 DeepSeek Harness |
 Hermes Agent |
 Pi Coding Agent |
 OpenClaw |
 OpenCode |
 WorkBuddy |
 Bub |
 Pydantic AI |
 LangChain |
LangGraph |
Python agent applications can use the LangChain middleware, the LangGraph node and tools adapter, the Pydantic AI middleware, or the Bub plugin.
Install the locked development environment and hooks:
make installRun the main validation commands before opening a pull request:
make check
make test
make docs-testAfter changing openapi/powercontext.yaml, run make contract-test. See CONTRIBUTING.md for the
complete workflow and docs/en/development/ for implementation guides.
Questions and feedback are welcome in Discord. Use GitHub Issues for reproducible defects and focused feature requests.
PowerContext is licensed under the Apache License 2.0.