docs: add Hermes Agent Cortex integration

README.md

@@ -149,6 +149,7 @@ Every memory, searchable. Every extraction, auditable.
 | **Claude Desktop** | Add MCP config → restart |
 | **Cursor / Windsurf** | Add MCP server in settings |
 | **Claude Code** | `claude mcp add cortex -- npx @cortexmem/mcp` |
+| **Hermes Agent** | Native memory provider or MCP server |
 | **Any app** | REST API: `/api/v1/recall` + `/api/v1/ingest` |
 
 ---
@@ -409,6 +410,50 @@ Settings → Developer → Edit Config:
 
 > Without auth: remove the `CORTEX_AUTH_TOKEN` line from `env`.
 
+
+### Hermes Agent
+
+Hermes Agent can connect to Cortex in two ways:
+
+1. **Native memory provider** for automatic pre-turn recall and post-turn ingestion.
+2. **MCP server** for explicit `cortex_*` tools in sessions where you prefer MCP-only access.
+
+#### Native memory provider
+
+Set Hermes config:
+
+```bash
+hermes config set memory.provider cortex
+```
+
+Add Cortex connection settings to the environment used by Hermes, typically `~/.hermes/.env`:
+
+```bash
+CORTEX_URL=http://127.0.0.1:21100
+CORTEX_AUTH_TOKEN=your-token-here
+CORTEX_AGENT_ID=hermes
+# Optional, useful when multiple Hermes instances share the same Cortex server
+CORTEX_PAIRING_CODE=your-instance-id
+```
+
+Restart Hermes after changing config or environment. Verify with:
+
+```bash
+hermes memory status
+```
+
+Expected result: provider `cortex`, plugin installed, status available.
+
+#### MCP tools
+
+If you only want explicit Cortex tools, configure Cortex as an MCP server in Hermes:
+
+```bash
+hermes mcp add cortex --command npx --args '@cortexmem/mcp --server-url http://127.0.0.1:21100'
+```
+
+For authenticated Cortex servers, include `CORTEX_AUTH_TOKEN` and `CORTEX_AGENT_ID` in the MCP server environment. After changing MCP config, restart Hermes or reload MCP if your current session supports it.
+
 ### Other MCP Clients
 
 <details>

README.zh-CN.md

@@ -152,6 +152,7 @@ Cortex 从你与记忆的互动中学习：
 | **Claude Desktop** | 添加 MCP 配置 → 重启 |
 | **Cursor / Windsurf** | 在设置中添加 MCP 服务器 |
 | **Claude Code** | `claude mcp add cortex -- npx @cortexmem/mcp` |
+| **Hermes Agent** | 原生记忆提供商或 MCP 服务器 |
 | **任何应用** | REST API: `/api/v1/recall` + `/api/v1/ingest` |
 
 ---
@@ -411,6 +412,50 @@ openclaw plugins install @cortexmem/openclaw
 
 > 不用认证：删除 `env` 中的 `CORTEX_AUTH_TOKEN` 行。
 
+
+### Hermes Agent
+
+Hermes Agent 有两种方式接入 Cortex：
+
+1. **原生记忆提供商**：每轮对话前自动 recall，每轮对话后自动 ingest。
+2. **MCP 服务器**：只暴露显式 `cortex_*` 工具，适合只想按需调用的场景。
+
+#### 原生记忆提供商
+
+设置 Hermes 配置：
+
+```bash
+hermes config set memory.provider cortex
+```
+
+把 Cortex 连接信息加入 Hermes 使用的环境文件，通常是 `~/.hermes/.env`：
+
+```bash
+CORTEX_URL=http://127.0.0.1:21100
+CORTEX_AUTH_TOKEN=你的令牌
+CORTEX_AGENT_ID=hermes
+# 可选：多个 Hermes 实例共用同一个 Cortex 服务时使用
+CORTEX_PAIRING_CODE=你的实例标识
+```
+
+修改配置或环境变量后重启 Hermes。用下面命令验证：
+
+```bash
+hermes memory status
+```
+
+预期结果：provider 为 `cortex`，plugin installed，status available。
+
+#### MCP 工具
+
+如果只需要显式 Cortex 工具，可以在 Hermes 里把 Cortex 配成 MCP 服务器：
+
+```bash
+hermes mcp add cortex --command npx --args '@cortexmem/mcp --server-url http://127.0.0.1:21100'
+```
+
+如果 Cortex 服务启用了认证，需要在 MCP server 环境里加入 `CORTEX_AUTH_TOKEN` 和 `CORTEX_AGENT_ID`。修改 MCP 配置后，重启 Hermes，或在当前会话支持时 reload MCP。
+
 ### 其他 MCP 客户端
 
 <details>

integrations/hermes-agent/README.md

@@ -0,0 +1,51 @@
+# Hermes Agent Cortex Provider
+
+Reference native memory provider for connecting Hermes Agent to Cortex through the Cortex REST API.
+
+## What it does
+
+- Enables `memory.provider: cortex` in Hermes Agent.
+- Recalls Cortex memories before each turn through `POST /api/v1/recall`.
+- Ingests completed turns after each response through `POST /api/v1/ingest`.
+- Exposes explicit tools: `cortex_recall`, `cortex_remember`, `cortex_forget`, `cortex_search`, `cortex_relations`, and `cortex_stats`.
+
+## Install into Hermes Agent
+
+Copy the provider directory into your Hermes Agent checkout or Hermes plugin path:
+
+```bash
+mkdir -p ~/.hermes/hermes-agent/plugins/memory
+cp -R integrations/hermes-agent/plugins/memory/cortex-provider-provider ~/.hermes/hermes-agent/plugins/memory/cortex
+```
+
+Set Hermes config:
+
+```bash
+hermes config set memory.provider cortex
+```
+
+Set environment variables for the Hermes process:
+
+```bash
+CORTEX_URL=http://127.0.0.1:21100
+CORTEX_AUTH_TOKEN=***
+CORTEX_AGENT_ID=hermes
+CORTEX_PAIRING_CODE=***
+```
+
+Restart Hermes after changing config or environment.
+
+Verify:
+
+```bash
+hermes memory status
+```
+
+Expected result: provider `cortex`, plugin installed, status available.
+
+## Notes
+
+- `CORTEX_URL` defaults to `http://127.0.0.1:21100`.
+- Non-sensitive settings can also live in `$HERMES_HOME/cortex.json`.
+- `CORTEX_AUTH_TOKEN` and `CORTEX_PAIRING_CODE` are read from environment variables.
+- Subagents and non-primary contexts can recall memories, but cannot write or delete memories.