インストール
- インタラクティブ(
droid) - スラッシュコマンド付きのチャット中心REPL - 非インタラクティブ(
droid exec) - 自動化とスクリプト用の単発実行
特定バージョンのインストール
CI runner、プロビジョニング済みの開発環境、その他の再現可能なシステムなど、アップグレードをレビューしたうえで意図的に適用する必要がある場合は、バージョンを固定してください。npm
正確なパッケージバージョンを指定します:組み込みアップデーター
スタンドアロンインストーラーで Droid をインストールした後、次のコマンドでバージョンを選択できます:droid update --check を使用してください。
スタンドアロンインストールではデフォルトで自動更新が有効です。バージョンを選択した後は、固定を維持するために自動更新のガイダンスに従ってください。
バイナリの直接ダウンロード
リリースバイナリとその SHA256 チェックサムは、次のパスで提供されます:<platform>:linux、darwin、またはwindows<arch>:x64、arm64、またはx64-baseline<binary>: Linux と macOS ではdroid、Windows ではdroid.exe
PATH 上のディレクトリに移動してください。ダウンロード URL の構成は実装の詳細であるため、必ずバージョンを固定し、チェックサムを検証してください。
CLIコマンド
CLIフラグ
コマンドラインフラグでdroidの動作をカスタマイズ:自律レベル
droid execは階層化された自律性を使用して、エージェントが実行できる操作を制御します。環境が安全な場合にのみアクセスレベルを上げてください。
例:
モデルID
-m, --modelまたは--spec-modelには、任意の利用可能なモデルIDを使用できます。カスタムモデルについては、Bring Your Own Key (BYOK)を参照してください。
どのモデルをどのタスクに使用するかのガイダンスについては、利用可能なモデルをご覧ください。
インタラクティブモードの機能
キーボードショートカット
インタラクティブREPLは、ナビゲーション、オーバーレイ、入力制御のための豊富なキーボードショートカットをサポートしています:Bashモード
入力が空の時に!を押すとbashモードを切り替えます。bashモードでは、コマンドはAIの解釈なしにシェルで直接実行されます。git statusの確認やnpm testの実行など、素早い操作に便利です。
- オンに切り替え:
!を押す(入力が空の時) - コマンドの実行: 任意のシェルコマンドを入力してEnterを押す
- オフに切り替え:
Escを押して通常のAIチャットモードに戻る
>から$に変わります。
Mermaid 図のレンダリング
Droid は Mermaid 図のコードブロックをターミナル上で直接 ASCII アートとして自動的にレンダリングします — 外部ビューアやブラウザは不要です。応答に対応する種類のフェンス付き```mermaid ブロックが含まれている場合、図はトランスクリプト内にインラインで描画されます。
対応している図種類:
flowchart(およびgraph)sequenceDiagramstateDiagramclassDiagramerDiagram
gantt、pie、mindmap、timeline、journey、gitGraph)は、生の Mermaid ソースと外部で図を表示するためのリンクの表示にフォールバックします。
スラッシュコマンド
droidをインタラクティブモードで実行している時に利用できます。プロンプトでコマンドを入力してください:
スラッシュコマンドの詳細については、インタラクティブモードのドキュメントをご覧ください。
Gitワークツリー
-w, --worktree [name] を使うと、ネイティブな Git worktree の中でセッションを実行できます。これにより、同じリポジトリの複数ブランチをファイル競合なしで並列に扱えます。このフラグは droid(インタラクティブ)と droid exec の両方で利用できます。
各ワークツリーは、リポジトリの隣接ディレクトリ(../<repo>-wt-<branch>/)に作成され、独立したチェックアウトと専用ブランチを持ちます。
ブランチ命名:
--worktree(値なし) —<current-branch>-wtという名前のブランチでワークツリーを作成または再利用します。--worktree <name>—<name>をブランチ名として使用します。ブランチがすでに存在する場合はそのワークツリーでチェックアウトされ、存在しない場合はHEADから作成されます。- 対象ブランチが別のワークツリーですでにチェックアウトされている場合、コマンドは明確なエラーを表示して失敗します。
- インタラクティブモード — セッション終了後もワークツリーは保持されるため、作業の再開、変更の確認、ブランチの push を行えます。
droid execモード — 終了時に、クリーンなワークツリー(未コミット変更なし)は自動的に削除されます。未コミット変更があるワークツリーは保持され、作業を確認できるようそのパスが表示されます。- 基盤となる Git ブランチは Droid によって削除されません。クリーンアップ時に削除されるのはワークツリーディレクトリだけです。
--worktree が有効な場合、Droid はワークツリーディレクトリ内で完全に動作します。後続の
コマンド(テスト、ビルド、インストール)は元のリポジトリルートではなく、そのディレクトリから
実行してください。新しく作成したワークツリーには依存関係(たとえば node_modules)がまだ
インストールされていない場合があるため、ビルドやテストがモジュール不足で失敗したときはセットアップしてください。サブコマンドのフラグ
上記のグローバルフラグに加えて、いくつかのdroid サブコマンドは独自のフラグを受け付けます。
droid update のフラグ
droid search のフラグ
droid mcp add のフラグ
droid plugin のフラグ
droid computer register のフラグ
MCPコマンドリファレンス
/mcpスラッシュコマンドは、MCPサーバーの閲覧と管理のためのインタラクティブマネージャーUIを開きます。
クイックスタート: /mcpと入力し、**「レジストリから追加」**を選択して40以上の事前設定されたサーバー(Linear、Sentry、Notion、Stripe、Vercelなど)を閲覧します。サーバーを選択し、必要に応じて認証を行えば準備完了です。
スクリプト化と自動化のためのCLIコマンド:
--env、--header)、設定ファイル、およびユーザーとプロジェクト設定のレイヤリング動作について確認してください。
認証
- app.factory.ai/settings/api-keysでAPIキーを生成します
- 環境変数を設定します:
~/.bashrc、~/.zshrc、またはPowerShell $PROFILE)に設定してください。
自動更新
スタンドアロンの Droid インストールでは、CLI の更新が自動的に確認・インストールされます。必要に応じて更新を実行するにはdroid update を実行してください。
スタンドアロンインストールを固定したままにするには、組み込みアップデーターを無効にしてください:
droid update を実行しても別のバージョンはインストールされません。droid daemon を含め、すべての Droid プロセスを起動する環境でこの変数を設定してください。
npm 配布版はビルド時に自動更新が無効化されているため、この変数は不要です。npm インストールから droid update を実行すると、自動更新を利用できないことが報告されます。FACTORY_DROID_AUTO_UPDATE_ENABLED=true を明示的に設定すると、npm ビルドのデフォルト設定を上書きできます。
Enterprise 管理者は、組織設定 disableAutoUpdate により、組織メンバー全員の CLI 自動更新を無効にできます。詳細はリリースノートおよびエンタープライズ制御変更履歴 APIを参照してください。
終了コード
一般的なワークフロー
コードレビュー
テストとデバッグ
リファクタリング
1つのリポジトリで並列セッションを実行する
CI/CD統合
関連項目
- クイックスタートガイド - Droid CLIの使い始め
- インタラクティブモード - ショートカット、入力モード、機能
- 利用可能なモデル - モデル選択のガイダンス
- 設定 - 設定オプション
- カスタムコマンド - 独自のショートカットを作成
- カスタムDroid - 専門的なエージェントを構築
- Droid Exec概要 - 詳細な自動化ガイド
- MCP設定 - 外部ツール統合
