Skip to content

One-click setup ​

Connect OpenViking to your coding agent with a single prompt. The agent installs the OpenViking memory plugin into the agents it finds on your machine, checks the connection, offers to bring in your recent work, and tells you how to restart. After the restart, your first question shows OpenViking at work.

The agent follows a short guide published as plain Markdown, so any agent can fetch it. There is one for the personal edition and one for the team edition; the install command is the same, only the guide differs:

  • Personal: https://docs.openviking.ai/agents/en/onboarding.md (Chinese: replace en with zh)
  • Team: https://docs.openviking.ai/agents/en/onboarding-team.md (likewise)

Both are also served from docs.openviking.net, which is usually faster from mainland China.

The prompt ​

First pick your edition in the prompt's header: Personal if you use OpenViking on your own, Team if you are a member of a team that shares folders in one OpenViking account. Copy the prompt and replace <API_KEY> with your key before you send it: on the personal edition, and for team admins, it is in the OpenViking console under User Management → API Key; team members get it from the OpenViking workbench their team gave them.

Prompt for your agent
text
Install the OpenViking memory plugin and help me start using it. OpenViking is a context database for AI agents (https://github.com/volcengine/OpenViking); the command and link below are from its official docs.

1. Run the official installer. It needs network access and writes to my home directory; if your sandbox blocks that, ask me for approval:
   curl -fsSL https://openviking.ai/install | bash -s -- --yes --lang en --url https://api.vikingdb.cn-beijing.volces.com/openviking --api-key <API_KEY>
2. Once it's installed, read the OpenViking onboarding guide and use it to walk me through setup. The guide has you ask me before choices like importing history or adding a working rule. docs.openviking.ai and docs.openviking.net are the same docs site; use whichever loads:
   https://docs.openviking.ai/agents/en/onboarding.md

The API key is one I created for myself in the OpenViking console; the installer stores it in ~/.openviking/ovcli.conf on this machine. Use it in the command as it is; there's no need to show it in your replies, and don't write it into any other file or rule. Talk to me in English.
text
Install the OpenViking memory plugin and help me start using it. OpenViking is a context database for AI agents (https://github.com/volcengine/OpenViking); the command and link below are from its official docs.

1. Run the official installer. It needs network access and writes to my home directory; if your sandbox blocks that, ask me for approval:
   curl -fsSL https://openviking.ai/install | bash -s -- --yes --lang en --url https://api.vikingdb.cn-beijing.volces.com/openviking --api-key <API_KEY>
2. Once it's installed, read the OpenViking onboarding guide and use it to walk me through setup. The guide has you ask me before choices like importing history or adding a working rule. docs.openviking.ai and docs.openviking.net are the same docs site; use whichever loads:
   https://docs.openviking.ai/agents/en/onboarding-team.md

The API key is my own, from the OpenViking console or workbench; the installer stores it in ~/.openviking/ovcli.conf on this machine. Use it in the command as it is; there's no need to show it in your replies, and don't write it into any other file or rule. Talk to me in English.

The installer sets up the plugin in every supported agent it detects on the machine, so other agents you have installed get it too; each one needs its own restart before the plugin works there. It also installs the ov command, which the agent uses to check the connection and add files. --lang sets the installer's language, and with it the language of the guide link it prints at the end. To limit the install to some agents, add --harness with a comma-separated list, for example --harness claude,cli; see Unified installer.

Self-hosted server. Replace the URL with your server's address. Use a user key; a root key can't read or write memories. For a local server without authentication, pass --api-key ''.

About the key. The installer accepts the key only as a command-line argument, so the key appears in this conversation and in your agent's local session history and logs. The guide tells the agent never to repeat it or write it anywhere. The plugins don't yet remove the key from the conversations they save, and the first save after the restart includes the install conversation: in Codex this happens whether you resume it or start a new session, so this install conversation, key included, can be saved to your own OpenViking account. In Claude Code a new session avoids it, which is why the agent asks you not to resume the install conversation there. If you'd rather not paste the key into a chat, run curl -fsSL https://openviking.ai/install | bash in a terminal yourself, then send your agent the prompt under Already installed.

Already installed ​

If the plugin is already installed, start a new session in your agent and send the line for your edition:

text
Follow https://docs.openviking.ai/agents/en/onboarding.md to walk me through my first use of OpenViking.
text
Follow https://docs.openviking.ai/agents/en/onboarding-team.md to walk me through my first use of OpenViking.

What the agent does ​

  1. Checks the install. It reads the installer's output and runs ov health, then tells you that you are connected and which agents were set up; if it is more than one, they all work from the same context.
  2. Explains what runs automatically. Before each prompt, the plugin recalls relevant memories. After each turn, it saves the conversation, and the server extracts long-term memories in the background. You don't need to approve this separately; asking for the install is the approval.
  3. Asks whether to bring in earlier work. The default is the current project's sessions from the last 14 days. You can also describe one kind of work, such as "the discussions about the payment refactor": the agent lists the candidate sessions with a preview of each, picks the ones that match, and shows you its picks before anything is sent. The import script reads Claude Code and Codex history itself; other agents first write a small converter that turns their own sessions into JSONL, then hand that to the same script. It tells you what it found and how much first, and imports only after you confirm; sessions that are already in OpenViking are not uploaded again. Right after the import it reads back from OpenViking where that work stands and what was decided, so you see what the import gave you before the restart. Only user and assistant text is sent; tool calls and their output are dropped and API keys are removed. If Claude Code or Codex history exists on the machine, other agents offer that too. You can also name files, such as a design doc, for the agent to add with ov add-resource to this project's folder in your personal resources.
  4. Offers a lasting collaboration rule. The agent offers to add a rule to your user-level rules file (for example ~/.claude/CLAUDE.md for Claude Code, ~/.codex/AGENTS.md for Codex), so it applies to all your projects: use the context OpenViking recalls and search only when that isn't enough; save important decisions (with the reasons), progress and next steps, and work products such as designs, research and deliverables to OpenViking on its own initiative, in one folder per project in your personal resources (resources/<project>/, with progress and decisions under notes/); look at what was saved first when continuing a project; and say briefly when it used or saved something. You can also have it adjust the rule for your role (product, engineering, marketing, design and so on), which adds what that role should keep. The rule sits between a pair of <!-- openviking:start --> / <!-- openviking:end --> markers and the rest of the file is left alone. It is written only if you agree, and read back afterwards. On agents that keep personal rules only in their settings (TRAE or Cursor, for example), the agent asks you to paste it there. It never writes rules into project files.
  5. Tells you how to restart. The plugin loads only when the agent starts again. The agent gives you the exact steps for the agent you are talking to. In Codex you first trust the OpenViking hooks (/hooks in the CLI, or the hooks icon below the input box in the desktop app), then quit, come back to the same conversation (codex resume --last in the CLI), and say "restarted"; if Codex still shows "Hooks need review", choose Trust all and continue. In Claude Code and the other agents you start a new session and send the first message it gives you. If the installer set up other agents too, it tells you they need a restart as well.
  6. Shows OpenViking at work. After the restart, your first question gets an answer drawn from recalled context, and the agent points out where that shows up: source cards in Claude Code, the OV-Usage line in Codex, and so on.

What the team edition adds. Step 1 explains the difference between your own space and the team's shared folders: your memories, sessions and personal material are visible only to you; the team's shared material is in viking://resources/ and shared agent skills are in viking://agent/skills/, and the context recalled before each prompt includes them. After the history import there is one more step: the agent lists what teammates have already contributed and which skills are shared, then asks whether to contribute the design documents and a progress summary of the imported project (or the current one, if nothing was imported) to viking://resources/<your user name>/<project>/, where the team's members can see them. The collaboration rule stores important decisions, progress and output in your own folder in the team folder by default, and keeps drafts and anything you say not to share in your personal space; you can switch it to "personal space by default, ask me before sharing". After the restart you can choose to get to know the team's shared context.

The agent asks you only for decisions: what to bring in (with a confirmation after you see the counts), on the team edition whether to contribute to the team, and whether to add the collaboration rule, each with what it gives you and what it sends or changes. Choices you have already made are not asked again.

See also ​

Open source under the AGPL-3.0 License. Font licenses