Skip to content

Feature overview ​

OpenViking is a context database for AI agents. It organizes resources, memories, skills, and rules as browsable, searchable files. OpenViking supplies context; an agent reads that context to answer questions or carry out tasks.

Start with the quickstart to get an answer you can check against its source. Then choose a task below. You do not need to read every page in sequence.

Start with a task ​

Your taskWhat OpenViking providesStart here
Answer questions using project sourcesImport, retrieve, and read source contentResource retrieval
Carry background into a new sessionRecord sessions, extract memory, and recall it for relevant tasksMemory use
Reuse a working methodStore and retrieve a Skill for an agent to read and applySkill use
Check tasks and actions against requirementsCompile mandatory constraints and recall rules for an agent to check against the current taskRules (Beta)
Organize sources into readable knowledgeCompile sources into a wiki or another Skill-defined outputContext compilation

Context types ​

TypeWhat it storesHow to check its value
ResourceExternal documents, web pages, and codeKey conclusions in an answer can be verified against sources
MemoryBackground, preferences, and experience extracted from sessionsA new session uses relevant background without you repeating it
SkillWorkflow instructions and supporting filesAfter reading the Skill, the agent produces an output that meets its requirements
Rule (Beta)Mandatory requirements under specific conditions, including obligations, prohibitions, and exceptionsThe agent checks applicable rules against task evidence and adjusts its actions or answer

A viking:// URI identifies content. Read it directly when you know the location; otherwise retrieve matches and open the source. Directory abstracts and overviews support progressive loading; their generation depends on the processing method and configuration.

Rules: For example, “A repository that declares itself open source must provide a locatable license text.” Explicitly compile mandatory requirements from a policy into Rules, then recall them for a specific task. OpenViking supplies the rules and their applicability conditions; the agent uses current evidence to check whether the requirements are met. Rules are in Beta. See Rules for concepts and usage.

Choose an entry point ​

The CLI, existing agents, and VikingBot connect to the OpenViking context service. The gateway connects compatible clients.

Entry pointUse it for
CLIBrowse, import, retrieve, and read from a terminal; use ov chat with an enabled VikingBot. See CLI basics.
Existing agentAdd context and memory to your daily tool. Capture, commit, and recall behavior varies by plugin; verify behavior in a new session after installation.
VikingBotUse the built-in agent for answers and tool-based tasks. The quickstart follows this route.
GatewayConnect a compatible client's model requests to context and memory. Verify the integration through capture, extraction, and recall results.
SDK / HTTPControl import, retrieval, sessions, and data management from your own application.

OpenViking manages and supplies context. The CLI, plugins, gateway, and agents have distinct responsibilities. For deeper integration, see Agent integrations, Gateway setup, or SDK and HTTP conventions.

Try skills and knowledge organization ​

Skills: Choose a workflow with a concrete output, install its Skill, confirm the agent can discover and read it, then run a task and inspect the result. OpenViking stores and retrieves the Skill; the agent activates it, manages tool permissions, and executes the task. See Skills for the operations.

Knowledge organization: Prepare sources, compile them with the Wiki Skill, wait for completion, and open an output page to check its evidence and omissions. Skill-based compilation needs a configured Compile Runtime. Compare the output with the original sources to check its accuracy. Continue with the Wiki example.

Next steps ​

Once you have a result, evaluate your own tasks. If you do not have a service endpoint, compare deployment modes.

Open source under the AGPL-3.0 License. Font licenses