searching-context

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

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

目次

• 使用する場面
• 検索モード
  • コンテキストを考慮した検索（ov search）
  • コンテンツパターン検索（ov grep）
  • ファイル glob 検索（ov glob）
• 検索オプション
  • 結果の制御
  • 範囲の制御
  • セッションを考慮した検索
• 出力
• その他のユーティリティ
  • コンテンツの一覧表示（ov ls）
  • ツリー表示（ov tree）
  • ファイルコンテンツの読み取り（ov read）
• エージェントのベストプラクティス
  • 検索方法の選択
  • クエリの作成
  • 他のコマンドとの組み合わせ
• 前提条件

使用する場面

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

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

検索モード

コンテキストを考慮した検索（ov search）

セッションコンテキストを考慮する主要な検索方法です。

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

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

# Limit results and set threshold
ov search "error handling" --limit 5 --threshold 0.7

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

リテラルパターンに一致するものを検索します。

# Search for exact text pattern
ov grep "viking://resources" "TODO:"

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

ファイル glob 検索（ov glob）

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

# Find all markdown files
ov glob "**/*.md"

# Find Python files in specific directory
ov glob --uri="viking://user/" "**/*.md"

検索オプション

結果の制御

# Limit number of results
ov search "authentication" --limit 5

# Set minimum relevance threshold (0.0-1.0)
ov search "deployment" --threshold 0.8

# Combine limit and threshold
ov search "monitoring" --limit 10 --threshold 0.7

範囲の制御

# Search specific directory
ov search "API design" --uri "viking://resources/xxx"

# Search within memories
ov search "user habits" --uri "viking://user/memories"

セッションを考慮した検索

# Search with session context (uses conversation history for better retrieval)
ov search "previous decision" --session-id "session-abc123"

出力

関連性スコア付きで、一致したリソースをランク順に返します。

URI: viking://resources/docs/api.md
Score: 0.8523
Abstract: API endpoints for user authentication...

URI: viking://user/memories/preferences
Score: 0.7891
Abstract: User prefers dark mode and compact layout...

その他のユーティリティ

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

ディレクトリ構造を表示します。

# List root directory
ov ls

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

# Simple path output (for scripts)
ov ls viking://resources --simple

# Recursive listing
ov ls viking://resources --recursive

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

# Control output limits
ov ls viking://resources --node-limit 50 --abs-limit 128

ツリー表示（ov tree）

ディレクトリ階層を視覚的に表示します。

# Show tree structure
ov tree viking://resources

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

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

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

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

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

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

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

エージェントのベストプラクティス

検索方法の選択

• ov search — 既定の選択肢です。コンテキストを考慮し、意味検索とディレクトリの再帰検索を組み合わせます。
• ov grep — 正確なテキストパターンを検索します（grep コマンドと同様）。
• ov glob — ファイルパスのパターンを検索します（シェルの glob と同様）。

クエリの作成

具体的で、コンテキストを含むクエリを作成します。

# Too vague
ov search "API"

# Better
ov search "REST API authentication with JWT tokens"

# Even better with scope
ov search "JWT token refresh flow" --uri "viking://resources/backend"

他のコマンドとの組み合わせ

検索結果を参考にして、次の操作を決めます。

ov ls viking://resources/

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

# Then read specific content
ov read viking://resources/backend/auth.md

# Or get overview for context
ov overview viking://resources/backend

前提条件

• CLI が設定済みであること：~/.openviking/ovcli.conf
• リソースまたはメモリーが OpenViking に追加済みであること