ccc

ccc - セマンティックコード検索とインデックス作成

ccc は CocoIndex Code の CLI で、現在のコードベースに対するセマンティック検索とインデックス管理を提供します。

所有権

現在のプロジェクトにおける ccc のライフサイクル（初期化、インデックス作成、検索）はエージェントが管理します。これらの手順をユーザーに依頼せず、自動的に実行してください。

• 初期化：ccc search または ccc index が初期化エラー（例：「初期化済みのプロジェクトディレクトリではありません」）で失敗した場合、プロジェクトのルートディレクトリから ccc init を実行し、続けて ccc index でインデックスを作成してから、元のコマンドを再試行してください。
  • 例外：ディレクトリに ccc のユーザー設定ディレクトリ（通常はホームディレクトリ）があるため ccc index が実行を拒否する場合、その場所では ccc init を実行しないでください。プロジェクト内から ccc を実行するか、どのプロジェクトを使うかユーザーに確認してください。
  • 例外：ccc のメモに、そのディレクトリが使用中のプロジェクトであると記載されている場合（その配下のリポジトリに独自のプロジェクトがない場合）は、ユーザーに伝えてください。その場所で ccc reset を自分で実行しないでください。プロジェクトとして維持するかどうかはユーザーが判断します。
• インデックスの鮮度：インデックスが古くなっている可能性がある場合（セッション開始時や、新しいファイルの追加、リファクタリング、モジュールの名前変更などの大きなコード変更後など）は、ccc index（または ccc search --refresh）を実行して最新の状態に保ってください。コードに変更がないまま連続して検索する場合、検索のたびに再インデックスする必要はありません。
• インストール：ccc 自体が見つからない場合（コマンドが見つからない場合）は、インストール手順を management.md で確認し、ユーザーに知らせてください。

コードベースの検索

セマンティック検索を実行するには：

ccc search <query terms>

クエリには、探している概念、機能、または動作を記述してください。正確なコード構文を指定する必要はありません。たとえば：

ccc search database connection pooling
ccc search user authentication flow
ccc search error handling retry logic

結果の絞り込み

• 言語別（--lang、複数指定可）：結果を特定の言語に限定します。

  ccc search --lang python --lang markdown database schema
  

• パス別（--path）：プロジェクトルートからの相対パスでグロブパターンを指定し、結果を限定します。省略した場合は、現在の作業ディレクトリが既定値となり、そのサブディレクトリ内の結果のみが返されます。

  ccc search --path 'src/api/*' request validation
  

ページネーション

結果の既定値は最初のページです。追加の結果を取得するには：

ccc search --offset 5 --limit 5 database schema

返された結果がすべて関連している場合は、--offset を使って次のページを取得してください。さらに有用な一致が見つかる可能性があります。

検索結果の利用

検索結果にはファイルパスと行範囲が含まれます。結果を詳しく確認するには：

• エディターに組み込まれたファイル読み込み機能（例：Read ツール）を使って一致したファイルを読み込み、返された範囲の前後の行を確認して全体の文脈を把握してください。
• ファイル読み込みツールのないターミナルで作業する場合は、sed -n '<start>,<end>p' <file> を使って特定の行範囲を抽出してください。

設定

埋め込みモデルの設定、対象に含める／除外するパターン、言語の上書き設定を確認または編集するには、settings.md を参照してください。

管理とトラブルシューティング

インストール、初期化、デーモン管理、トラブルシューティング、クリーンアップの各コマンドについては、management.md を参照してください。