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