OpenViking (OV) add-resource

The ov add-resource command imports external resources into OpenViking's context database — supporting local files, directories, URLs, and remote repositories. Resources are automatically processed with semantic analysis and organized under the viking://resources/ namespace.

When to Use

• Importing project documentation, code repositories, or reference materials

• Adding web pages, articles, or online resources for future retrieval

• Building a knowledge base from external sources

• When an agent encounters valuable content that should persist across sessions

Input Options

Basic Usage

Import a local file or URL:

Import from URL

ov add-resource https://raw.githubusercontent.com/volcengine/OpenViking/main/README.md

Import local file

ov add-resource ./docs/api-spec.md

Import local directory

ov add-resource ./project-source

Context and Instructions

Add metadata to guide processing:

Provide reason for import

ov add-resource ./api-docs.md --reason "REST API documentation for v2 endpoints"

Add processing instructions

ov add-resource ./large-repo --instruction "Focus on authentication and authorization patterns"

Combine reason and instruction

ov add-resource https://example.com/guide --reason "User guide" --instruction "Extract best practices and examples"

Async Processing Control

Wait for semantic processing to complete:

Wait until processing finishes

ov add-resource ./docs --wait

Wait with timeout (in seconds)

ov add-resource https://example.com/docs --wait --timeout 60

Fire and forget (default)

ov add-resource ./docs

Output

Returns the root URI of the imported resource:

root_uri viking://resources/...

Prerequisites

• CLI configured: ~/.openviking/ovcli.conf

• Network access for URL imports

• Read permissions for local files/directories