gety-cli

使用方法

/gety-cli <natural language query>

例

/gety-cli What docx files have I updated in the last 24 hours?
/gety-cli Find meeting notes about the Q1 roadmap
/gety-cli Search for PDF documents related to security review in my Work folder
/gety-cli What's in my notes about the design system?
/gety-cli Show me the latest documents I've worked on
/gety-cli What data sources do I have connected?
/gety-cli Add ~/Documents/projects as a data source

ワークフロー

- [ ] Step 1: Verify gety and discover data sources ⛔ BLOCKING
- [ ] Step 2: Translate query to gety command(s)
- [ ] Step 3: Execute and iterate
- [ ] Step 4: Read specific documents (conditional)
- [ ] Step 5: Synthesize findings ⚠️ REQUIRED

ステップ 1：gety を確認し、データソースを検出する ⛔ BLOCKING

gety connector list を実行します（フォルダーとカスタムコネクターの両方を確認するには、gety connector list --kind all を実行します）。

• 出力がある場合 → 次に進みます。後のステップで -c フィルターの値として使うため、返されたコネクター名を控えておきます。
• コマンドが見つからない場合 → Gety デスクトップアプリの設定から Gety CLI をインストールするようユーザーに伝えます。gety コマンドは実行しないでください。
• コネクターがない場合 → 先にデータソースを追加するようユーザーに伝えます（フォルダーには gety connector add <path>、カスタムコネクターには gety connector install <dir> を使用します）。

ステップ 2：クエリを gety コマンドに変換する

ユーザーの自然言語クエリを解析し、gety CLI フラグに対応付けます。

ユーザーの意図	対応するもの
ファイルの種類（「docx ファイル」、「PDF」）	-e <ext>
データソース（「Work フォルダーから」、「メモ内で」）	-c "<connector_name>"
期間（「過去 24 時間」、「今週」）	--update-time-from / --update-time-to（ISO 8601）
新しさ（「最近の」、「最新の」）	--sort-by update_time --sort-order descending
トピックまたはキーワード	<query> 文字列
タイトル検索（「X という名前の」、「タイトルが X の」）	--match-scope title
データソースの一覧表示	→ gety connector list（--kind fs / --kind custom / --kind all）
コネクターの詳細を確認	→ gety connector show <id>
フォルダーのデータソースを追加	→ gety connector add <path> [--name <name>]
カスタムコネクターをインストール	→ gety connector install <directory> [--config <file>]
コネクターを設定	→ gety connector configure <id> [options]
コネクターを再起動	→ gety connector restart <id>
コネクターを同期／ポーリング	→ gety connector poll <id>
コネクターを有効化／無効化	→ gety connector enable <id> / gety connector disable <id>
データソースを削除	→ gety connector remove <id> ⚠️ 先にユーザーに確認します

時間の計算：クエリに相対的な時間（「過去 24 時間」、「今週」）が含まれる場合は、現在の日付／時刻から ISO 8601 のタイムスタンプを計算します。

変換例

クエリ	コマンド
「過去 24 時間に更新した docx ファイルは何ですか？」	gety search "" -e docx --sort-by update_time --sort-order descending --update-time-from <24h ago>
「Q1 ロードマップに関する議事録を探して」	gety search "Q1 roadmap meeting notes"
「Work フォルダー内にあるセキュリティ関連の PDF」	gety search "security" -c "Folder: Work" -e pdf
「利用できるデータソースは何ですか？」	gety connector list --kind all
「カスタムコネクターの状態を確認して」	gety connector show <connector_id>

ステップ 3：実行して繰り返す

変換したコマンドを実行します。結果が適切でない場合：

• 無関係な結果が多すぎる → フィルター（-c、-e、--match-scope）を追加します
• 結果が少なすぎる → クエリの範囲を広げ、類義語を試し、フィルターを削除します
• さらに結果が必要 → --offset でページネーションします
• 後続処理用の構造化データが必要 → --json を追加し、jq にパイプします

ステップ 4：特定のドキュメントを読む（条件付き）

ドキュメントの内容が必要な場合：

gety doc <connector_id> <doc_id>

• 検索結果から connector_id と doc_id を抽出します
• すでに得ている情報に新たな情報を加えるドキュメントのみを読みます
• 検索結果が大量にある場合は、まず関連性の高い上位 3〜5 件を読みます

⚠️ 大きなドキュメントの処理（コンテキストウィンドウの保護）

gety doc はドキュメント全体の内容を出力します。サイズの大きいファイル（長い PDF、書籍、ログ、大量のデータダンプ）では出力が膨大になり、コンテキストを圧迫してトークンを無駄にすることがあります。

大きなファイルのベストプラクティス：

1. 一時ファイルに保存してから、ツールで検索する（推奨）： 出力をファイルにリダイレクトし、grep、rg、または head で関連するセクションを確認します：

   gety doc <connector_id> <doc_id> > /tmp/gety_doc.txt
   grep -i -C 3 "keyword" /tmp/gety_doc.txt
   head -n 50 /tmp/gety_doc.txt
   

2. ページ分けされたドキュメントではページ範囲を指定する： ドキュメントにページがある場合（例：PDF）は、--page-start と --page-end で範囲を絞ります：

   gety doc <connector_id> <doc_id> --page-start 1 --page-end 5
   

3. スニペットで十分な場合は読み込みを避ける： gety search の検索結果だけですでに十分なコンテキストが得られている場合は、ドキュメント全体を取得しないでください。

ステップ 5：調査結果をまとめる ⚠️ 必須

• 複数のドキュメントから得た情報を組み合わせ、一貫性のある回答を作成します
• 情報の出典がわかるように、参照元のドキュメント名またはパスを記載します
• 関連する検索結果が見つからない場合は、その旨を明確に伝え、代わりの検索語を提案します
• gety の出力を生のまま貼り付けてはいけません。必ず自然な文章にまとめてください

避けるべきパターン

• ❌ 要約せずに gety の出力をそのまま提示する
• ❌ 大きなドキュメントの内容をすべて会話コンテキストに読み込む。ファイルに保存して grep で検索するか、--page-start／--page-end でページ分けしてください
• ❌ 検索結果にあるすべてのドキュメントを読む。必要なものだけを読みます
• ❌ 検索を 1 回試しただけで諦める。別のクエリやフィルターを試してください
• ❌ CLI の範囲外のコマンドを使用する（使用できるのは search、doc、connector のみ）
• ❌ ユーザーに gety コマンドを手動で実行するよう頼む。コマンドは自分で実行してください

リファレンス

CLI のオプション、フラグ、使用例の詳細については、references/cli-capabilities.md を読み込んでください