@hippomemory/opencode

HippoMemory memory plugin for OpenCode — auto-capture, auto-recall, and hippomemory_remember / hippomemory_search tools, backed by a HippoMemory endpoint (local or remote). Ported from the upstream cognee-integrations @cognee/cognee-opencode package.

What changed vs upstream

| Aspect | upstream | this package | | --- | --- | --- | | Package | @cognee/cognee-opencode | @hippomemory/opencode | | Env vars | COGNEE_SERVICE_URL / COGNEE_API_KEY / … | HIPPO_BASE_URL / HIPPO_API_KEY / … primary, COGNEE_* fallback | | Local default | http://localhost:8000 | unchanged — matches the HippoMemory backend port | | Session prefix | oc_<project>_<hash> | opencode_<project>_<hash> — matches the HippoMemory dashboard's opencode_ detection | | Tools | cognee_remember / cognee_search | hippomemory_remember / hippomemory_search | | Project config key | cognee: {...} | hippomemory: {...} (old cognee: key still honored) |

Install

npm publish pending — publishing @hippomemory/opencode to npm requires the owner's npm account and has not been done yet. Until then, install from a checkout of this repo:

cd hippo-integrations/integrations/opencode
npm install && npm run build
npm install -g .

Once published, the one-liner becomes:

npx @hippomemory/opencode setup

Configure

export HIPPO_BASE_URL="http://localhost:8000"
export HIPPO_API_KEY="<your-api-key>"

Or in the OpenCode project config:

{
  "hippomemory": {
    "baseUrl": "http://localhost:8000",
    "apiKey": "<your-api-key>",
    "datasetName": "opencode_sessions"
  }
}

COGNEE_SERVICE_URL / COGNEE_API_KEY continue to work as fallbacks.