ov-search-context

OpenViking（OV）のコンテキスト検索

ov search コマンドは、OpenViking 内のすべてのメモリーとリソースを対象に、コンテキストを考慮した検索を実行します。意味理解とディレクトリの再帰検索を組み合わせ、あらゆるクエリに最も関連するコンテキストを見つけます。

目次

• 使用する場面
• 検索用サブコマンド
  • ディレクトリの一覧表示（ov ls）
  • ツリー表示（ov tree）
  • セマンティック検索（ov find）
  • コンテンツパターン検索（ov grep）
  • ファイルグロブ検索（ov glob）
  • コンテンツ全体の読み取り（ov read）
  • 概要の取得（ov overview）
  • 抄録の取得（ov abstract）
• 前提条件

使用する場面

• インポートしたリソースや保存済みのメモリーから特定の情報を探すとき
• 以前に追加したトピック、API、パターンに関するコンテキストを取得するとき
• プロジェクトのドキュメント、コード、学習内容を横断して検索するとき
• エージェントが以前に保存した知識を参照する必要があるとき

注：CLI コマンドが古くなっている場合があります。エラーが発生したときは、--help を使用して最新の使い方を確認してください。

検索用サブコマンド

コンテンツの一覧表示（ov ls）

ディレクトリ構造を参照します：

# 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

ツリー表示（ov tree）

ディレクトリ階層を可視化します：

# 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

セマンティック検索（ov find）

意味的な関連度で順位付けして検索します：

# 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

コンテンツパターン検索（ov grep）

リテラルパターンに一致する内容を検索します：

# 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"

ファイルグロブ検索（ov glob）

ファイルパスのパターンに一致するものを検索します：

# 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

ファイルコンテンツの読み取り（ov read）

コンテンツ全体を取得します（L0-L2 レイヤー）：

# 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

検索の組み合わせ

検索結果を参考に、さらに操作を進めます：

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

前提条件

• CLI の設定が完了していること：~/.openviking/ovcli.conf
• リソースまたはメモリーが事前に OpenViking に追加されていること