capture

capture — 取り込みの単一エントリーポイント

ユーザーが思いつき、記事の抜粋、文字起こしの一部、その他のテキストを自分のブレインに保存したい場合は、gbrain capture を実行してください。gbrain put や、コミットしてから同期する方法は使わないでください。capture が入り口となり、ローカルインストールとシンクライアントのインストールの両方を同じように処理します。

契約

• 入力： 保存するコンテンツ（インライン引数、--file PATH、または --stdin）。
• 出力： ブレイン DB 内のページと、<sync.repo_path>/<slug>.md 配下のディスク上の Markdown ファイル。レシートは標準出力に表示されます。
• 副作用： ページは gbrain query、gbrain search、または MCP に接続された任意のエージェントから、すぐにクエリ可能になります。
• 冪等性： 同じコンテンツなら、同じ inbox/YYYY-MM-DD-<hash8> スラッグになります。デーモンによる24時間のコンテンツハッシュ重複排除で、再キャプチャも検出されます。
• 信頼性： このスキルを通じてキャプチャされたものは、すべてローカル CLI の信頼レベル（remote: false）になります。信頼できない Webhook からの取り込みには、この動詞ではなく POST /ingest を使います。

呼び出すタイミング

• 「この考えをキャプチャして」／「これを保存して」／「これをブレインに入れて」／「これを覚えておいて」
• ユーザーがコンテンツを貼り付けて、保存するよう依頼したとき
• 会議の要約、調査メモ、またはブレインのページとして残すべきあらゆる統合内容の作成後

動作

gbrain capture は、put_page 呼び出し（ローカル）またはリモート MCP 呼び出し（シンクライアント）に解決されます。どちらの場合も、v0.38 のライトスルー処理により、ページは一度の操作で DB とディスクの両方に保存されます。既定のスラッグは inbox/YYYY-MM-DD-<hash8> なので、キャプチャした内容は予測しやすいトリアージ用の場所にまとまります。

使用方法

gbrain capture "the thought I want to remember"
gbrain capture --file ./notes/today.md
echo "from a pipe" | gbrain capture --stdin
gbrain capture "..." --slug daily/2026-05-21
gbrain capture "..." --type idea --source voice-whisper
gbrain capture "..." --quiet          # script-friendly: prints just the slug
gbrain capture "..." --json           # structured output for agents

既定値

• スラッグ： inbox/YYYY-MM-DD-<hash8>（同じコンテンツなら安定します。デーモンによる24時間の重複排除で、再キャプチャも検出されます）。
• タイプ： note（--type idea などで上書きできます）。
• フロントマタースタンプ： captured_via: capture-cli、captured_at: <ISO>。
• タイトル： 本文の最初の空でない行を最大80文字まで使用します（切り詰める場合は末尾に … が付きます）。

出力形式

既定では、5行のレシートを出力します。

captured:
  slug:          inbox/2026-05-21-abcdef12
  status:        created_or_updated
  content_hash:  f3a7b9c0d1e2f3a4…
  file:          /Users/you/brain/inbox/2026-05-21-abcdef12.md
  captured_at:   2026-05-21T04:15:00.000Z

--quiet を指定すると、スラッグのみを出力します（SLUG=$(gbrain capture "..." --quiet) で使用します）。 --json を指定すると、後続のツール向けに構造化された出力を行います。

失敗した場合

gbrain のエラー code、終了コード、[AGENT] ブロック、または notice ブロックがある場合は、エージェント運用者プロトコルに従ってください。このスキル固有の対応は以下のとおりです。

• 終了コード10（write_pending）：思いつきは受け付けられており、まだコミットされる可能性があります。保存済みで保留中であることをユーザーに伝え、gbrain write-request <request_id> をポーリングしてください。二度目のキャプチャは絶対に行わないでください。
• シークレットスキャンまたはスラッグフェンスによる拒否：何も保存されていません。何が拒否されたかをユーザーに伝えてください。スキャナーをすり抜けるためにコンテンツを編集してはいけません。
• MCP 経由での source_binding_required または insufficient_scope：この接続には対象ソースへの書き込み権限がありません。ブレインホストの運用者から許可を受ける必要があるソースをユーザーに伝えてください。

アンチパターン

• gbrain put を使わないでください。 これはページ単位の古いプリミティブで、既定のスラッグ生成、コンテンツタイプの推定、レシートブロックに対応していません。capture は人が使うためのラッパーです。
• gbrain capture をループで実行して、何十個ものファイルを一括インポートしようとしないでください。 その用途には gbrain sync（または gbrain import）を使います。Capture は単一の思いつき、単一のメモ、単一の文字起こし向けです。
• 必要がない限り、フロントマターを自分で付けてコンテンツを事前に整形しないでください。 Capture はプレーンテキストを、適切なフロントマター（タイプ＋タイトル＋captured_via＋captured_at）で囲みます。本文は # Title\n\n<your prose> になります。すでに完全に整形された Markdown ファイルがある場合は、--file PATH を渡してください。
• シークレットをインラインコンテンツとして渡さないでください。 インライン引数はシェルの履歴に残ります。代わりに --file または --stdin を使ってください。

このスキルを使用しない場合

• 多数のファイルを一括取り込みする場合 → 代わりに skills/media-ingest/SKILL.md または gbrain sync を使用してください
• 著者情報と公開メタデータがある記事／リンクの場合 → skills/idea-ingest/SKILL.md（人物ページの作成方法がわかっています）
• 会議の文字起こしの場合 → skills/meeting-ingestion/SKILL.md（参加者情報の補完）

このスキルは、シンプルに「思いついたことを保存したい」というケース向けです。専用の取り込み手順では、スラッグの生成と相互参照をそれぞれ処理します。