Repository navigation
feat(hermes): implement powercontext plugin for hermes - #1261
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Implements a Hermes Agent integration that exposes PowerContext as a standard Hermes MemoryProvider, including a dependency-free (stdlib) HTTP client, provider lifecycle hook mappings, agent memory tools, and a hermes powercontext CLI command group. This adds an optional, additive long-term memory backend while keeping Hermes in control of orchestration and session lifecycle.
Changes:
- Added the PowerContext Hermes provider implementation (lifecycle hooks + tool handling) and plugin metadata/config schema.
- Added a stdlib-only HTTP client and a Hermes CLI command tree for provider operations.
- Added documentation and integration tests for provider behavior, tool mapping, and CLI registration.
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
tests/integrations/test_hermes_provider.py |
New integration tests validating provider prefetch, turn sync, pre-compress persistence, tool mapping, fail-open behavior, and CLI registration. |
integrations/hermes/README.md |
End-user documentation for installation, configuration, runtime behavior, and CLI usage. |
integrations/hermes/plugins/powercontext/README.md |
Plugin-level README pointing users to the main integration docs and CLI examples. |
integrations/hermes/plugins/powercontext/plugin.yaml |
Hermes plugin metadata + declared hook support. |
integrations/hermes/plugins/powercontext/config_schema.py |
Declarative schema for Hermes provider configuration UI/validation. |
integrations/hermes/plugins/powercontext/client.py |
Stdlib HTTP client wrapper for the PowerContext endpoints used by the provider. |
integrations/hermes/plugins/powercontext/cli.py |
hermes powercontext CLI command group implementation. |
integrations/hermes/plugins/powercontext/__init__.py |
Core PowerContextMemoryProvider implementation, tool schemas, hook mappings, and registration entry point. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
222twotwotwo
pushed a commit
to 222twotwotwo/powercontext
that referenced
this pull request
Aug 23, 2026
* implement hermes plugin * fix comments * fix memory extractrion error * memory_ref.revision * update readme * fix yaml and sync * ruff format * fix comments * update readme * add header * add header
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Which issue or RFC does this PR close?
Closes #1260
Rationale for this change
hermes use demo

hermes cli use demo

This PR implements the proposed integration between PowerContext and Hermes Agent as a standard Hermes
MemoryProvider.Hermes remains responsible for Agent orchestration, memory lifecycle management, session handling, and tool scheduling. PowerContext acts as the external long-term memory backend for searchable historical context, memory storage, context preparation, memory extraction, and memory lifecycle operations.
The integration is designed to be additive:
What changes are included in this PR?
integrations/hermes/.MemoryProvider.prefetch()andqueue_prefetch()use/v1/context/prepare.sync_turn()captures completed turns through/v1/sources/content.on_session_end()waits for pending writes and triggers/v1/memory/flush.on_pre_compress()persists bounded conversation context before compression.on_memory_write()mirrors Hermes built-in memory additions and replacements.powercontext_search_memorypowercontext_get_memorypowercontext_rememberpowercontext_retire_memory$HERMES_HOME/powercontext.jsonhermes powercontextCLI command group:statussearchremembergetretireflushAre there any user-facing changes?
Yes.
Users can install and enable PowerContext as a Hermes memory provider:
A running PowerContext server is required. The provider uses:
by default and supports configuration through
$HERMES_HOME/powercontext.jsonor environment variables.The following CLI commands are available after Hermes discovers the provider:
The integration does not add third-party runtime dependencies to Hermes and does not change Hermes core behavior when the provider is disabled.
How was this change tested?
AI usage statement
This PR was developed with assistance from OpenAI Codex.