WireCat Google Drive

drive-cli

drive は、選択した Google Drive フォルダーをローカルの Markdown スナップショットと検索可能なドキュメントに取り込みます。すべてのタブにある Google ドキュメントを読み取り、名前の変更や移動があってもソースの識別情報を保持し、WireCat 共通のキーワード検索とオプションのローカル埋め込みを再利用します。共有タグ、メモ、編集者の識別情報、証拠に基づく記憶は、取り込んだドキュメントに紐付いたままになります。

Drive は Google の公式 Node クライアントを使用します。 現在サポートされているソースは、ネイティブの Google ドキュメントとスプレッドシート、PDF、docx、xlsx、CSV、TSV、アップロードされた Markdown/TXT です。 その他の種類とショートカットはスキップとして報告されます。ショートカットをたどって、選択した範囲外に移動することはありません。

gog、Workspace MCP、rclone との比較、および別のツールがより適している場合については、他のツールとの比較をご覧ください。

インストール

22.x 系の Node 22.16 以降、または Node 24 以降を使用して、コンパイル済み CLI をインストールします。ソースからのビルドは不要です：

npm install -g @wirecat/drive-cli
drive --version
drive --help

インストールと Google への接続をご覧ください。ソースからのビルドはコントリビューター向けです。

drive doctor は、サインインせずにバージョン、設定ファイル、プロファイル、パスを表示します。また、drive upgrade は drive をインストールしたパッケージマネージャーを使って、新しいバージョンをインストールします。

drive guide はシナリオ、つまり一般的なタスクを実行するためのコマンドを順に表示します。drive commands --json はコマンドツリー全体を表示します。エージェントの場合、drive skill install は Claude Code、Codex、Gemini CLI、OpenClaw が参照する場所に drive の説明を配置します（Hermes の場合は --for hermes を指定します）。drive personal mcp serve は 3 つの MCP ツール（検索、読み取り、書き込み）を提供します。--http を指定すると、ブラウザー上の ChatGPT と Claude にツールを提供します（リモート MCP）。また、DRIVE_READ_ONLY=1 は --read-only と同様、あらゆる変更を拒否します。

サインインしてフォルダーを選択する

WireCat に付属する Google アプリケーションでサインインします。各ユーザーはブラウザーで自分のアカウントを承認します。Google による Drive 権限の審査はまだ完了していないため、Google は最初に「未確認のアプリ」という警告を表示し、アプリケーションの新規ユーザー数を合計 100 人に制限します。詳しくは警告と続行方法をご覧ください。インストールガイドの説明に従って、独自のデスクトップクライアントを作成することもできます。アカウントを接続し、フォルダーを選択します。

drive personal session start
drive personal folders add https://drive.google.com/drive/folders/FOLDER_ID
drive personal sync --json

Google Cloud の設定と、ほかから分離した初回実行については、ブラウザーでのサインインとライブ検証ガイドをご覧ください。

サインインするとシステムブラウザーが開き、一時的なループバックポートで Google のコールバックを受け取ります。--no-browser を指定すると URL が表示されます。drive.readonly はアカウント全体の読み取りを許可しますが、選択したフォルダーのスコープによって取り込み対象が制限されます。同期ではリモートファイルを読み取ります。リモート管理用のオプションコマンドを使うには、session start --grant write で再度サインインする必要があります。履歴イベントを使うには、session start --grant activity でサインインしてください。

認証情報は OS のキーリングに保存されます。キーリングがない場合は、--credential-storage file を明示的に選択してください。共有ヘルパーが、所有者のみがアクセスできる非公開ファイルに書き込みます。トークンが通常の設定、出力、診断情報に含まれることはありません。付属のアプリケーションの代わりに、DRIVE_GOOGLE_CLIENT_ID と DRIVE_GOOGLE_CLIENT_SECRET でアプリケーションの設定を指定できます。--client-file を指定した場合は、そちらが優先されます。付属のデスクトップクライアントの ID は公開アプリケーションメタデータであり、ユーザーの非公開トークンとは別です。独自のデスクトップクライアントを作成してテストモードのままにすると、通常 Google は 7 日後にそのクライアントでのサインインを終了します。 Google OAuth ガイド、 Drive の権限。

別のアカウントには drive work … を使います。Google アカウントごとに、ローカルプロファイルが 1 つあります。drive session list では、設定済みのプロファイルを一覧表示します。session end は、キャッシュデータと設定を保持したままローカルのサインイン情報を削除するため、再ログイン後もドキュメント ID が維持されます。

検索とエクスポート

drive personal search 'budget decision' --json
drive personal search 'budget' --exact --json
drive personal documents list --json
drive personal documents show DOC_ID --json
drive personal documents export DOC_ID --output ./document.md
drive personal status --json
drive commands sync --json

検索結果には、元の Google URL が含まれます。documents show には、各タブのテキスト、ID、タイトルが含まれます。ネイティブの Markdown エクスポートは、インデックス作成に使われる全タブのテキストとは別に保存されます。エクスポート先に既存のファイルがある場合、上書きは行われません。

セマンティック検索では、共有のローカルテキストモデル（約 135 MB）を使います。モデルは一度ダウンロードすればよく、プロファイルもサインインも必要ありません。すべての WireCat CLI で共有されます。

drive models download e5-small
drive personal sync --embed

Drive がモデルを独自にダウンロードすることはありません。モデルが見つからない場合は、その旨が報告されます。--exact を指定すると、セマンティック検索を行わずに単語を検索します。

最新の状態を保つ

drive personal sync --limit 200 --json
drive personal folders remove FOLDER_ID
drive personal sync --json

バッチは処理前に保存され、中断した作業は次回の実行時に再開されます。進捗は 25 ファイルごと、または 2 秒ごとに保存されるため、同期を強制終了しても、やり直しは最大でその分だけです。選択したフォルダーの初回走査は、進行に合わせて保存されます。走査が中断された場合は、まだ一覧表示していないフォルダーから再開します。変更カーソルはバッチの完了時に進みます。検出が完了しなかった場合、以前のチェックポイントとドキュメントは保持されます。プロファイルごとのハートビートロックにより、同期の同時実行を防ぎ、クラッシュ後に復旧します。

削除が確認されたソースと対象範囲外になったソースは検索対象から除外され、そのスナップショットも削除されます。最後に選択したフォルダーを削除すると、次回の同期でキャッシュが空の状態に同期されます。サポート対象外、アクセス制限あり、サイズ超過のソースには、対象状況が明示されます。一時的なエラーは保留状態のままです。エラーを含む部分的な同期は、ゼロ以外の終了コードで終了します。重複は名前ではなくドキュメント ID で区別されます。

ストレージと対象範囲

共有パスヘルパーは、drive-cli 配下にプラットフォームに適した設定、データ、キャッシュのディレクトリを選択します。DRIVE_CONFIG_DIR、DRIVE_STATE_DIR、DRIVE_CACHE_DIR で上書きできます。スナップショットは profiles/<profile>/documents/<file-id>.md と、非公開の JSON メタデータおよび Docs の生のレスポンスで構成されます。

ドキュメントは、Memo、Telegram、MAX と同じローカル WireCat データベースを使用します。インポートした内容は、メッセージやノートとともに、これらのツール全体で検索できます。別のデータベースを選択するには MESSAGING_STORE を使用します。WIRECAT_STATE_DIR を設定すると、WireCat のデフォルトディレクトリを変更できます。Google のサインイン情報は引き続き分離されます。

アップグレード後の初回使用時、Drive は管理対象のスナップショットから古いドキュメント参照を再構築し、Google から取得は行いません。古いデータベースは保持されます。そのデータベースにタグ、ノート、メモリー、ファクト、関係性が含まれている場合、Drive はそれらが取り残されないようにします。それらの注釈が移行されるまで、MESSAGING_STORE を通じてそのファイルを使い続けてください。

検索対象には、すべてのタブの本文、ネストされた表、脚注が含まれます。画像、ヘッダー、フッター、コメント、提案された編集は対象外です。画像アセットはダウンロードされません。検索テキストと Google ネイティブの Markdown エクスポートは別の形式です。レイアウトやタブの対象範囲が重要な場合は、エクスポートを確認してください。

1 回の同期で読み取る項目数は、選択したフォルダー内で最大 10,000 件、Google の変更フィードから最大 10,000 件です。いずれかの上限を超えると、何も失われることなく処理を停止し、次の手順を案内します。テキストは最大 2,000,000 文字、スナップショットは最大 50 MiB で、ページネーションにも上限があります。サイズ超過の入力は切り詰めずに拒否されます。Google のネイティブエクスポートにも、別途 10 MB の上限があります。エクスポート中に変更されたドキュメントは、再試行のため保留されます。

ドキュメントのナレッジとリモート操作

drive personal tags add DOC_ID project-budget review
drive personal documents list tag:review
drive personal notes add DOC_ID 'Check the assumptions' --title Review
drive personal identities list DOC_ID
drive personal documents context DOC_ID
drive personal facts add DOC_ID 'Budget approved for Q4' --type decision --scope work
drive personal memories add DOC_ID 'Q4 budget, in short' --scope work --kind summary
drive personal memories extract DOC_ID --scope work
drive personal documents history DOC_ID
drive api list service:docs

AI 抽出では、選択したキャッシュ済みテキストが設定済みのモデルに明示的に送信されます。--yes を指定しない場合、提案のプレビューが表示されます。保存された提案には、出典の引用、スナップショットのハッシュ、モデルによる作成情報が含まれます。共通のモデル設定で models set --provider openai --model MODEL_ID を使用してください。プロバイダーのキーは、対応する API キー環境変数から取得され、通常の設定に保存されることはありません。ソースの内容が変更された場合や、対象範囲から削除された場合、ソースに基づくメモリーは古いものとしてマークされます。ユーザーノートはローカルに保持されます。

生成された API は 85 のメソッドを公開します。内訳は Drive が 64、Sheets が 17、Docs が 3、Activity が 1 です。便利なコマンドには、ファイルの一覧表示、コピー、移動、ゴミ箱への移動と復元、フォルダーの作成、Docs の作成と一括更新、コメント、権限、リビジョン、共有ドライブの操作が含まれます。デフォルトでは読み取り権限が付与されます。JSON API 呼び出しで変更や完全削除を行うには、明示的なフラグが必要です。Google は引き続き、ファイルのロールと API ポリシーを適用します。

完全な例、権限、履歴の上限、AI 設定、サポートされるリクエスト形式については、ナレッジと API コマンドのガイドを参照してください。コントリビューター向けのチェックでは、分離されたソースとモック化されたプロバイダーリクエストを使用します。テストガイドを参照してください。