dosu

Dosu CLI を使用する

dosu を通じて Dosu を操作します。構造化出力を優先し、CLI と App による製品ルールの検証を活用してください。

正しく開始する

1. dosu --version を実行します。無関係なパッケージマネージャーのコマンドでインストール状況を調べないでください。
2. 利用できず、Node が存在する場合は、npx -y @dosu/cli --version を試し、このセッションでは npx -y @dosu/cli をコマンドの接頭辞として使用します。それ以外の場合は、何かをインストールする前に確認してください。
3. コマンドリファレンスに記載されていないコマンドを使用する前に、dosu --help または該当するネストされた --help を実行します。
4. リーフコマンドで --json が使用できる場合は、必ず指定します。結果を解析し、人間向けの表をスクレイピングしないでください。

適切な前提条件を満たす

• dosu login は、tRPC を使用するコマンドで使う JWT を提供します。
• dosu setup は、組織、Library のコンテキスト、MCP デプロイメントを選択し、API キーを作成して、エージェントツールを設定できます。
• dosu ask には API キーが必要です。docs generate、docs auto-tag、docs publish には、JWT によるログインと API キーの両方が必要です。その他のプラットフォームコマンドでは通常、JWT によるログインが必要です。組織または現在の Library を対象とするコマンドでは、対応するセットアップ項目の選択も必要です。
• コーディングエージェントのセットアップでは、workflows.md にある、ブロッキングを伴わない dosu setup --agent --tool <id> ワークフローに従います。URL を伝え、返された resume_command を実行してください。チケットコマンドを独自に作成しないでください。

現在の製品用語を使用する

• Organization は、アカウントと権限の境界です。
• Library は、App に表示されるナレッジコンテナです。旧 API では space と呼ばれる場合がありますが、この内部名をユーザーに提示しないでください。
• Data source は、リポジトリ、Slack チャンネル、Notion ワークスペースなど、組織レベルの接続です。Library は、すでに接続されているソースを使用できます。
• Agent は、GitHub、GitLab、Slack、または Teams にデプロイして設定できるもので、1 つの Library のみを対象とします。
• Monitor は Library とソースごとに設定されます。GitHub、GitLab、Azure DevOps のソースに対応しています。
• dosu deployments は、選択可能な MCP デプロイメントを管理します。Agent の CRUD コマンドとして使用しないでください。

意図に応じて使い分ける

意図	使用するコマンド
Dosu をエンドツーエンドでセットアップする（「set up dosu」、新しい Library をゼロから作成する）	まず workflows.md のガイド付きオンボーディングフローを読みます。これはチェックポイント方式です。質問し、待ってから実行してください
Library を作成または設定する	dosu libraries ...
既存の組織ソースを接続する	dosu sources list → dosu libraries sources attach
Agent を作成または設定する	dosu agents ...
要約された回答を得る	dosu ask
ソースドキュメントを探す	dosu knowledge search の後に dosu docs get
ドキュメントを作成、インポート、または公開する	dosu docs ...
保留中のドキュメント変更または返信の下書きを確認する	まず review-workflow.md を読みます
会話を確認する	dosu threads ...
管理対象のトピックを閲覧する	dosu topics ...
Agent のドキュメント、README、アーキテクチャ、または依存関係を監査する	まず audit.md を読みます

詳細なコマンドとフラグのリファレンスとして使用するのは、commands.md のみです。複数コマンドの組み合わせには、workflows.md のみを使用してください。

Library と Agent のセマンティクスを適用する

• Library を構成するには、組織のソースを一覧表示し、Library を作成して、選択したソース ID を紐付けた後、libraries info と libraries sources list で確認します。CLI から新しい OAuth 接続を確立することはできません。
• libraries sources config は App 側でプロバイダーを解決します。プロバイダー固有のオプションを選択する前に、コマンドリファレンスを確認してください。
• GitHub リポジトリを使って Library を作成する場合、または既存の Library に新たに紐付ける場合は、ユーザーが希望しない旨を伝えない限り、Monitor もそのセットアップの一部として扱います。リポジトリ全体と emoji のデフォルト設定で有効にし、確認したうえで、Monitor はプルリクエストをレビューして Library のナレッジを最新の状態に保つものだと説明します。Library のワークフローに従ってください。デフォルトを選ぶようユーザーに尋ねないでください。
• 既存のソース ID から Agent を作成し、デフォルト設定は App に選ばせてください。シェルコマンドで設定を作成しないでください。各データソースをバックエンドにできる Agent は最大 1 つです。agents create が CONFLICT（409）を返した場合、そのソースにはすでに Agent が存在します。再試行するのではなく、別のソースを提示するか、許可を得たうえで agents move を使ってください。
• 既存の Agent を変更する前に、設定を読み取ってください。変更するのは既存のリーフ 1 つだけにしてください。値は JSON 形式です。並行書き込みで CONFLICT が返された場合は、再度読み取り、要求された変更を再評価し、それが依然として正しい場合に限り再試行してください。
• Agent を移動すると、その Library が置き換えられます。返された space_id を確認してください。移動結果から過去のデータの移行動作を推測しないでください。

書き込みの境界を守る

• ユーザーが正確な変更を明示的かつ明確に要求した場合は、それを許可とみなします。それ以外の場合は、予定している変更を提示し、確認を待ってください。
• --confirm を指定できるコマンドでは、プレビューが役立つ場合はまず省略してください。{ "confirmRequired": true, "applied": false } は何も変更されていないことを意味します。許可を得た後に限り、--confirm を指定してください。
• レビュー項目をまとめて承認したり、まとめて却下したりしないでください。項目を 1 つずつ差分表示し、その内容を説明して、ユーザーが許可した ID のみを処理してください。
• Library、Agent、ソース、ドキュメントを削除する前に、対象と影響を明示してください。ソースの紐付けを解除する前に、コマンドリファレンスに記載された影響を読み取り、ユーザーに伝えてください。一部の古い削除コマンドでは --confirm が強制されません。CLI の確認プロンプトがないことは、ユーザーの承認を意味しません。
• ソースを公開 Library に紐付ける前に、そのコンテンツが当該 Library にアクセスできるすべてのユーザーに公開されることを警告してください。
• OAuth 接続と課金は引き続きウェブ上でのみ行えます。成功したと主張せず、その制約を伝えてください。

失敗をそのまま扱う

• Not logged in または回復不能なセッション期限切れの場合：dosu login を実行します（Agent のセットアップでは、代わりにチケットフローが返される場合があります）。
• 組織、Library、デプロイメント、または API キーのコンテキストが不足している場合：該当する dosu setup フローを実行します。
• confirmRequired：書き込みは行われていません。
• 設定で CONFLICT が発生した場合：再試行する前に再読み取りします。
• tRPC またはバックエンドのエラーは、操作の失敗を意味します。コード／パス／ステータスを伝え、要求された状態が存在するかのように示唆しないでください。

参考資料

• commands.md：CLI の構文、選択肢、デフォルト、競合、前提条件に関する正式な情報
• workflows.md：複数コマンドで再利用できるワークフロー
• review-workflow.md：レビューの安全性とコンテキスト
• audit.md：リポジトリ監査の手順
• audit-findings-schema.md：.dosu/audit.json の仕様