PowerContext
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.
Quick start
You need macOS or Linux, Python 3.11 or newer, uv, and at least one supported agent
host.
1. Install PowerContext and integrations
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 opencode \
--source oceanbase/powercontext --ref master
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
Keep the Server running in one terminal:
powercontext server run
In another terminal, verify the service and plugin:
powercontext doctor
powercontext doctor integrations
powercontext doctor codex # Replace codex with the host you installed.
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.
Core capabilities
| 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 |
Benchmarks
LoCoMo
SWE-bench Pro public v2
The evaluation ran in a Codex environment, with both the PowerContext OFF and ON groups using the gpt-5.6-sol
model.
Integrations
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.
Official integrations
 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.
Development
Install the locked development environment and hooks:
make install
Run the main validation commands before opening a pull request:
make check
make test
make docs-test
After changing openapi/powercontext.yaml, run make contract-test. See CONTRIBUTING.md for the
complete workflow and docs/en/development/ for implementation guides.
Community
Questions and feedback are welcome in Discord. Use GitHub Issues for reproducible defects and focused feature requests.
License
PowerContext is licensed under the Apache License 2.0.
1 maintainer
Release files for powercontext 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| powercontext-0.1.0.tar.gz | 3.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| powercontext-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.8 MB
Release files / powercontext-0.1.0.tar.gz
| Download URL | powercontext-0.1.0.tar.gz |
|---|---|
| Size | 3.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
18d47a335340b0870216e2cc0fb1fd8e4d865880155daeea3b01187c950fd746
|
|
BLAKE2b-256 checksum How to use checksums |
bad710c2d2c48756a6fd0c745ae262c0fad19fd6c409df2b6da9b93483805fc7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 31, 2026.
Transparency logRelease files / powercontext-0.1.0-py3-none-any.whl
| Download URL | powercontext-0.1.0-py3-none-any.whl |
|---|---|
| Size | 605.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
94f8fef36d4afcee09dd5231fbe5edfe47e42e41994596b775e2f203ef6fac72
|
|
BLAKE2b-256 checksum How to use checksums |
34fe7dea5176821e4b11602d7f665c8eedd92e416e05f1000cbfa15e7cad48e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 31, 2026.
Transparency log
