# Openviking Memory

Recall and persist long-term memory through the OpenViking MCP tools.

- Repository: https://github.com/volcengine/OpenViking (41301 stars)
- Category: Testing
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add volcengine/OpenViking --skill openviking-memory -g -a claude-code -y`
Codex: `npx skills add volcengine/OpenViking --skill openviking-memory -g -a codex -y`
Cursor: `npx skills add volcengine/OpenViking --skill openviking-memory -g -a cursor -y`
Gemini CLI: `npx skills add volcengine/OpenViking --skill openviking-memory -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add volcengine/OpenViking`

## Description

Recall and persist long-term memory through the OpenViking MCP tools. Use at the start of any substantive task (coding, configuration, debugging, multi-step or tool-based work) to retrieve relevant prior knowledge with find/search/read, and during or after work to persist durable facts, preferences, decisions, and lessons with remember. Do not use for casual chat or simple factual questions the model can answer directly.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# OpenViking Memory

OpenViking is a long-term semantic memory store addressed by `viking://` URIs.
This client has no lifecycle hooks, so nothing is recalled or captured
automatically, you drive both halves of the loop with the `openviking` MCP
tools.

Core tools, available on every supported deployment:

- Recall: `find`, `search`, `read`, `list`, `grep`, `glob`
- Persist: `remember`, `add_resource`
- Maintain: `forget`, `health`

Some deployments register more than the core set, `tree`, `write`, `edit`,
`list_watches`, `cancel_watch`. These are optional: which ones exist depends
on the server version and hosting mode (the managed cloud service trims some
of them). Check the session's registered tool list; if any optional tool is
present, read [references/optional-tools.md](references/optional-tools.md)
before using it. Never call a tool that is not registered, and do not fall
back to raw HTTP. If no OpenViking tools are registered at all, continue
without memory.

## Recall: at task start

The rest: https://github.com/volcengine/OpenViking/blob/HEAD/agent-plugins/skills/openviking-memory/SKILL.md