OpenSkillIndex← back to search
claude-code

OpenViking ov-search-context

Search context data(memories, skills and resource) from OpenViking Context Database (aka. ov). Trigger this tool when 1. need information that might be stored as memories, skills or resources on OpenViking; 2. is explicitly requested searching files or knowledge; 3. sees `search context`, `search openviking`, `search ov` request.

install
source · Clone the upstream repo
git clone https://github.com/volcengine/OpenViking
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/volcengine/OpenViking "$T" && mkdir -p ~/.claude/skills && cp -r "$T/examples/skills/ov-search-context" ~/.claude/skills/volcengine-openviking-ov-search-context && rm -rf "$T"
manifest: examples/skills/ov-search-context/SKILL.md
source content

OpenViking (OV) context searching

The 

ov search
command performs context-aware retrieval across all memories and resources in OpenViking — combining semantic understanding with directory recursive retrieval to find the most relevant context for any query.

Table of Content

  • When to Use
  • Sub-commands for search
    • List directories (
      ov ls
      )
    • Tree view (
      ov tree
      )
    • Semantic Search (
      ov find
      )
    • Content Pattern Search (
      ov grep
      )
    • File Glob Search (
      ov glob
      )
    • Full content read (
      ov read
      )
    • Get overview (
      ov overview
      )
    • Get Abstract (
      ov abstract
      )
  • Prerequisite

When to Use

  • Finding specific information within imported resources or saved memories
  • Retrieving context about topics, APIs, or patterns previously added
  • Searching across project documentation, code, and learnings
  • When an agent needs to reference previously stored knowledge

note: cli command can be outdated, when sees error, use 

--help
to get latest usage

Sub-commands for search

List Contents (
ov ls
)

Browse directory structure:

# List root directory
ov ls

# List specific directory
ov ls viking://resources/my-project/docs/

# Simple path output (only uris, no metadata)
ov ls viking://resources --simple

# Show hidden files
ov ls viking://resources --all

# Control output limits (default 256)
ov ls viking://resources --node-limit 50

# Control abstract info length limit for each node (default 256)
ov ls viking://resources --abs-limit 128

Tree View (
ov tree
)

Visualize directory hierarchy:

# Show tree structure
ov tree viking://resources

# Control depth limits (default 3)
ov tree viking://resources --level-limit 2

# Control node limits
ov tree viking://resources --node-limit 100 --abs-limit 128

# Show all files including hidden
ov tree viking://resources --all

Semantic find (
ov find
)

Find method with semantic relevance ranking:

# Basic find across all context
ov find "how to handle API rate limits"

# Find within specific URI scope
ov find "authentication flow" --uri "viking://resources/my-project"

# Limit results and set relevance score threshold
ov find "error handling" --node-limit 5 --threshold 0.3

Content Pattern Search (
ov grep
)

Literal pattern matching:

# Find exact text pattern (Note: this is expensive, and suggest within specific small URI scope)
ov grep "viking://resources" "TODO:" --uri "viking://resources/my-project"

# Case-insensitive search
ov grep "viking://resources" "API_KEY" --ignore-case --uri "viking://resources/my-project"

# Limit results and set node limit
ov grep "viking://resources" "API_KEY" --node-limit 5 --uri "viking://resources/my-project"

File Glob Search (
ov glob
)

File path pattern matching:

# Find all markdown files (Note: this is expensive, and suggest within specific small URI scope)
ov glob "**/*.md" --uri "viking://resources/my-project"

# Limit results and set node limit
ov glob "**/*.md" --uri "viking://resources/my-project" --node-limit 5

Read File Content (
ov read
)

Retrieve full content (L0-L2 layer):

# Read full content
ov read viking://resources/docs/api/api-1.md

# Read first 10 lines of api-2.md
ov read viking://resources/docs/api/api-2.md | head -n 10

# Read abstract (L0 - quick summary)
ov abstract viking://resources/docs/api/
ov read viking://resources/docs/api/.abstract.md

# Read overview (L1 - key points)
ov overview viking://resources/docs/api/
ov read viking://resources/docs/api/.overview.md

Combining Search

Use search results to guide further actions:

ov ls viking://resources/

# Search for relevant files
ov search "authentication" --uri "viking://resources/project-A"

# Get overview for context
ov overview viking://resources/project-A/backend

# Decide to read specific content
ov read viking://resources/project-A/backend/auth.md

Prerequisites

  • CLI configured: 
    ~/.openviking/ovcli.conf
  • Resources or memories previously added to OpenViking