fabric-cli

Fabric.so CLI ワークフロー

利用可能なインターフェースがネイティブ CLI または認可済みの Fabric コネクターである場合は、直接使用してください。第 2 のコマンドカタログでラップしたり、プランナーの read ラベルをアクセス制御の保証として扱ったりしないでください。

ツールとワークスペースを確認する

fabric --version
fabric --help
fabric --json workspace current
fabric --json workspace list
fabric search --help

同じ名前の別の実行可能ファイルではなく、Fabric.so であることを確認してください。ヘルプ／バージョンの確認はローカルで完結しますが、ワークスペースの確認ではアカウントの状態にアクセスします。書き込みを行う前に、終了ステータスと返されたワークスペースを確認してください。ワークスペース名は曖昧な場合があるため、プロバイダー ID が表示される場合は保持してください。ワークスペースを切り替えると、CLI のコンテキストが永続的に変わります。操作を直列化するか、文書化されたコマンドごとのスコープを使い、対象を再確認してください。

公式インストーラーは https://fabric.so/cli/install.sh です。認可されたインストールの前にダウンロードして内容を確認してください。リモートコードを既定でシェルにパイプしてはいけません。セットアップにはブラウザーでのログインを優先してください。fabric auth <api-key> はプロセス引数や履歴にシークレットを含めます。サポートされている保護された認証方法を使用し、認証情報をメモに記録したりコピーしたりしないでください。インストール済みの CLI に記載されていない環境変数への対応を捏造しないでください。

エビデンスを検索して取得する

fabric --json search "project notes"
fabric --json search "design" --tag work
fabric --json path
fabric --json path "Inbox/Reports"

候補となるコンテンツの検索には検索を、既知のフォルダーの閲覧にはパスのブラウジングを使用してください。クエリ、タグ、ワークスペース、ページネーションに関する制限を明示してください。スニペットはソース全体ではありません。詳細な要約が必要な場合は、サポートされている CLI／API／コネクターのアクションを通じて元のコンテンツを取得してください。ソース文書の代わりに Fabric AI アシスタントの解釈を黙って使ったり、検索結果が網羅的だと想定したりしないでください。

fabric ask は委任されたエージェント実行です。 文書化された用途には、アシスタントに作業を依頼することが含まれます。自然言語での「読み取り専用」プロンプトや、以前の ask-read プランナーラベルによって、ツールや書き込み、課金対象の推論が無効になるわけではありません。意図したスコープを明確にしたうえでのみ使用し、エビデンスの取得には実際のリソース読み取りを使用してください。

正確なコンテンツと種類を指定して保存する

認可された書き込みでは、種類が判明している場合は note、link、または file を使用してください。save は種類を自動判定するため、パスに似たテキストがノートではなくファイルとしてアップロードされることがあります。使用前に、その判定を確認してください。

fabric --json note --parent "Work/Projects" < "/private/output/reviewed-note.md"
fabric --json link "https://example.com" --title "Reference" --parent "Work/Reading"
fabric --json file "/absolute/path/reviewed-report.pdf" --parent "Work/Reports"

note コマンドの位置引数のテキストは、タイトルではなく本文です。タイトルは、インストール済みのコマンドで案内されているフラグを使う場合にのみ、別途設定してください。アップロード前にバイト列と添付ファイルのスコープを確認し、保存先の制約を守り、返された ID を保持してください。対応している場合は ID で作成されたリソースを確認してください。検索インデックスへの反映が遅れることがあるため、見つからなくても失敗とは限りません。

タスクと変更操作

完了／編集／削除の前に、fabric --json task list を読み取り、対象のタスクを正確に特定してください。フィールド、優先度、期限、識別子については、最新の task help を使用してください。期限とリマインダーの配信、およびタイムゾーンを含む時刻は区別してください。一括操作では、対象 ID の明示的な一覧を事前に確認してください。変化するクエリを計画として再実行しないでください。削除、ワークスペースの変更、リモートアシスタントの実行には、実際のユーザースコープが必要です。フラグや同梱レシピから権限を推測してはいけません。

標準出力、標準エラー、終了ステータス、想定される応答形式は、それぞれ別々に確認してください。解析に失敗したという理由だけで、--json を付けずに変更操作を再実行してはいけません。 操作はすでに成功している可能性があります。元の結果を保存し、ID／現在の状態で照合し、結果が不明な場合はその旨を報告してください。適切な場合は読み取りを回数制限付きで再試行してください。作成、保存、委任された ask について、文書化されていない冪等性を想定しないでください。

プロジェクトのメモリ

ユーザーまたは確立されたプロジェクト指示で Fabric の永続メモリが認可されている場合にのみ、memory and handoff を使用してください。関連性の高いものを少数取得し、出典情報を保持してから、簡潔なメモを作成して保存してください。生の会話をアップロードしたり、ヒューリスティックな機密情報の削除処理ですべてのシークレットが取り除かれると信頼したりしないでください。

根拠を添えて完了する

検証済みのワークスペース、見つかった／変更された ID、関連するソースコンテンツ、未解決の結果を報告してください。生成された完了スクリプトは実行可能なシェルコードです。シェルの起動ファイルを読み込んだり編集したりする前に、スクリプトを確認してください。このスキルに記載された構文を見ただけで、CLI コマンドが認証済みになるわけではありません。

最新の公式ソース、2026-09-13 に確認： Fabric CLI ガイド。 アプリケーション SDK の作業には、これらのターミナル用レシピではなく fabric-api を使用してください。