Skip to main content

インストール

CLIは2つのモードで動作します:
  • インタラクティブ(droid - スラッシュコマンド付きのチャット中心REPL
  • 非インタラクティブ(droid exec - 自動化とスクリプト用の単発実行

特定バージョンのインストール

CI runner、プロビジョニング済みの開発環境、その他の再現可能なシステムなど、アップグレードをレビューしたうえで意図的に適用する必要がある場合は、バージョンを固定してください。

npm

正確なパッケージバージョンを指定します:
npm で公開されるバイナリはビルド時に自動更新が無効化されているため、インストールしたバージョンは固定されたままです。アップグレードするには、新しいバージョンを npm で明示的にインストールしてください。

組み込みアップデーター

スタンドアロンインストーラーで Droid をインストールした後、次のコマンドでバージョンを選択できます:
このコマンドでは古いバージョンへのロールバックも行えます。インストールせずに利用可能な更新を確認するには、droid update --check を使用してください。
スタンドアロンインストールではデフォルトで自動更新が有効です。バージョンを選択した後は、固定を維持するために自動更新のガイダンスに従ってください。

バイナリの直接ダウンロード

リリースバイナリとその SHA256 チェックサムは、次のパスで提供されます:
  • <platform>: linuxdarwin、または windows
  • <arch>: x64arm64、または x64-baseline
  • <binary>: Linux と macOS では droid、Windows では droid.exe
例として、Linux x64 バイナリをダウンロードして検証する手順は次のとおりです:
検証済みのバイナリを PATH 上のディレクトリに移動してください。ダウンロード URL の構成は実装の詳細であるため、必ずバージョンを固定し、チェックサムを検証してください。

CLIコマンド

CLIフラグ

コマンドラインフラグでdroidの動作をカスタマイズ:
スクリプトや自動化には--output-format jsonを使用して、droidの応答をプログラム的に解析できます。

自律レベル

droid execは階層化された自律性を使用して、エージェントが実行できる操作を制御します。環境が安全な場合にのみアクセスレベルを上げてください。 例:
--skip-permissions-unsafeはすべての安全性チェックを削除します。Dockerコンテナなどの分離された環境でのみ使用してください。

モデルID

-m, --modelまたは--spec-modelには、任意の利用可能なモデルIDを使用できます。カスタムモデルについては、Bring Your Own Key (BYOK)を参照してください。 どのモデルをどのタスクに使用するかのガイダンスについては、利用可能なモデルをご覧ください。

インタラクティブモードの機能

キーボードショートカット

インタラクティブREPLは、ナビゲーション、オーバーレイ、入力制御のための豊富なキーボードショートカットをサポートしています:
/terminal-setup を一度実行して、Shift+Enter がチャット入力で確実に改行を生成するようターミナルを設定してください。

Bashモード

入力が空の時に!を押すとbashモードを切り替えます。bashモードでは、コマンドはAIの解釈なしにシェルで直接実行されます。git statusの確認やnpm testの実行など、素早い操作に便利です。
  • オンに切り替え: !を押す(入力が空の時)
  • コマンドの実行: 任意のシェルコマンドを入力してEnterを押す
  • オフに切り替え: Escを押して通常のAIチャットモードに戻る
bashモードがアクティブの時、プロンプトが>から$に変わります。

Mermaid 図のレンダリング

Droid は Mermaid 図のコードブロックをターミナル上で直接 ASCII アートとして自動的にレンダリングします — 外部ビューアやブラウザは不要です。応答に対応する種類のフェンス付き ```mermaid ブロックが含まれている場合、図はトランスクリプト内にインラインで描画されます。 対応している図種類:
  • flowchart(および graph
  • sequenceDiagram
  • stateDiagram
  • classDiagram
  • erDiagram
未対応の図種類(たとえば ganttpiemindmaptimelinejourneygitGraph)は、生の 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コマンド
MCP設定で、完全なレジストリリスト、CLIオプション(--env--header)、設定ファイル、およびユーザーとプロジェクト設定のレイヤリング動作について確認してください。

認証

  1. app.factory.ai/settings/api-keysでAPIキーを生成します
  2. 環境変数を設定します:
変数を保持する ためには、長期利用のためにシェルプロファイル(~/.bashrc~/.zshrc、またはPowerShell $PROFILE)に設定してください。
APIキーをソース管理にコミットしないでください。環境変数またはセキュアなシークレット管理を使用してください。

自動更新

スタンドアロンの Droid インストールでは、CLI の更新が自動的に確認・インストールされます。必要に応じて更新を実行するには droid update を実行してください。 スタンドアロンインストールを固定したままにするには、組み込みアップデーターを無効にしてください:
この変数を設定すると、自動更新は無効になり、droid update を実行しても別のバージョンはインストールされません。droid daemon を含め、すべての Droid プロセスを起動する環境でこの変数を設定してください。 npm 配布版はビルド時に自動更新が無効化されているため、この変数は不要です。npm インストールから droid update を実行すると、自動更新を利用できないことが報告されます。FACTORY_DROID_AUTO_UPDATE_ENABLED=true を明示的に設定すると、npm ビルドのデフォルト設定を上書きできます。 Enterprise 管理者は、組織設定 disableAutoUpdate により、組織メンバー全員の CLI 自動更新を無効にできます。詳細はリリースノートおよびエンタープライズ制御変更履歴 APIを参照してください。
再現可能な環境では CLI を固定し、自動更新を無効にしてください。ローカルの開発者インストールでは、修正やセキュリティアップデートを受け取るために自動更新を有効のままにしておくことを推奨します。

終了コード

一般的なワークフロー

コードレビュー

ローカルコードレビューのドキュメントで、レビューの種類、ワークフロー、ベストプラクティスの詳細なガイダンスをご覧ください。

テストとデバッグ

リファクタリング

1つのリポジトリで並列セッションを実行する

Gitワークツリー を参照してください。

CI/CD統合

関連項目