openviking-memory

v0.7.5

Long-term semantic memory for Codex, powered by OpenViking. Recall on UserPromptSubmit, incremental add_message on Stop (per turn), commit on PreCompact, and active-window heuristic + idle-TTL sweep on SessionStart (source=startup|clear). Includes a local stdio MCP proxy that reads OpenViking credentials from env/ovcli.conf.

Codex1 skill1 MCP serverstdio

by OpenVikingApache-2.028.1kupdated 1 day ago

Source

$ git clone https://github.com/volcengine/OpenViking

Clone the source, then follow the repository's marketplace instructions for your runtime. The plugin root is examples/codex-memory-plugin/ inside the repository.

Layout

examples/codex-memory-plugin/

├── .codex-plugin/plugin.json
├── skills/ov-experience-memory/SKILL.md
└── .mcp.json

Skills1

ov-experience-memoryskills/ov-experience-memory/SKILL.md

Use OpenViking experience memories during task execution. Search relevant experiences with search_experience, read selected experiences with read_experience, and leave standard tool parts in the committed session so OpenViking can report recall and injection usage.

MCP servers1

openviking-memorystdio

command: node
args: servers/mcp-proxy.mjs
cwd: .

Manifests1

examples/codex-memory-plugin/.codex-plugin/plugin.json

{
  "name": "openviking-memory",
  "version": "0.7.5",
  "description": "Long-term semantic memory for Codex, powered by OpenViking. Recall on UserPromptSubmit, incremental add_message on Stop (per turn), commit on PreCompact, and active-window heuristic + idle-TTL sweep on SessionStart (source=startup|clear). Includes a local stdio MCP proxy that reads OpenViking credentials from env/ovcli.conf.",
  "author": {
    "name": "OpenViking",
    "url": "https://github.com/volcengine/OpenViking"
  },
  "repository": "https://github.com/volcengine/OpenViking",
  "license": "Apache-2.0",
  "keywords": [
    "memory",
    "openviking",
    "semantic-search",
    "long-term-memory",
    "context-engine",
    "codex"
  ],
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "OpenViking Memory",
    "shortDescription": "Long-term semantic memory for Codex",
    "longDescription": "Hooks Codex's lifecycle to keep an external semantic memory: recall relevant memories on each UserPromptSubmit; on every Stop (turn end) append the new user/assistant turns to a long-lived OpenViking session keyed by codex session_id; on PreCompact commit that session so OV's extractor produces durable memories before context is summarized; on SessionStart(source=startup|clear) commit eligible orphaned sessions using the active-window and idle-TTL rules. Also exposes OpenViking's native MCP tools through a local stdio proxy to the streamable-HTTP /mcp endpoint for manual use.",
    "developerName": "OpenViking",
    "category": "Productivity",
    "capabilities": [
      "Automatic memory recall on each prompt",
      "Incremental conversation capture per turn",
      "Pre-compaction memory extraction",
      "Session archive search and original-text read-back",
      "Resource ingestion for RAG (add_resource)",
      "Explicit MCP tools for retrieval, memory, resources, watches, filesystem, and code navigation",
      "Experience Memory skill with dedicated search_experience and read_experience tools"
    ],
    "websiteURL": "https://github.com/volcengine/OpenViking"
  }
}