自然言語でファイルの中身を検索したいときに使用する。semtoolsの使用ガイド。
Inherits all available tools
Additional assets for this skill
This skill inherits all available tools. When active, it can use any tool Claude has access to.
| コマンド | 説明 | API |
|---|---|---|
search | ローカルセマンティック検索 | 不要 |
workspace | 大規模検索用のキャッシュ管理 | 不要 |
parse | PDF/DOCX/PPTX → Markdown 変換 | LlamaParse API |
grep の代わりにセマンティック(意味的)な検索ができる。キーワードが完全一致しなくても関連する内容を見つける。
# 基本的な使い方
search "検索クエリ" ファイルパス
# 進捗ファイルを検索
search "認証機能の実装" .agents/progress/*.md
# 距離しきい値を調整(小さいほど厳密)
search "API設計" docs/*.md --max-distance 0.3
# 前後の行数を指定
search "エラーハンドリング" src/*.ts --n-lines 5
--max-distance <float>: 類似度しきい値(デフォルト: 0.5、小さいほど厳密)--n-lines <int>: マッチ前後の行数(デフォルト: 3)多数のファイルを頻繁に検索する場合、インデックスを作成して高速化する。
# インデックス作成
workspace index ./docs
# インデックスを使って検索
workspace search "クエリ" ./docs
PDF、DOCX、PPTX を Markdown に変換する。LlamaParse API キーが必要。
# 変換
parse document.pdf
parse reports/*.docx
# PDF を変換してから検索
parse docs/*.pdf | xargs search "API endpoints"
# grep と組み合わせ
search "認証" src/*.ts | grep -v test
~/.semtools_config.json:
{
"llama_cloud_api_key": "llx-..."
}
優先順位: CLI 引数 > 設定ファイル > 環境変数