CLIリファレンス

droid コマンドラインインターフェースの完全リファレンス（コマンドとフラグを含む）

​

インストール

macOS/Linux

curl -fsSL https://app.factory.ai/cli | sh

CLIは2つのモードで動作します：

• インタラクティブ（droid） - スラッシュコマンド付きのチャット中心REPL
• 非インタラクティブ（droid exec） - 自動化とスクリプト用の単発実行

​

CLIコマンド

コマンド	説明	例
droid	インタラクティブREPLを開始	droid
droid "query"	初期プロンプトでREPLを開始	droid "explain this project"
droid exec "query"	インタラクティブモードなしでタスクを実行	droid exec "summarize src/auth"
droid exec -f prompt.md	ファイルからプロンプトを読み込み	droid exec -f .factory/prompts/review.md
cat file | droid exec	パイプされたコンテンツを処理	git diff | droid exec "draft release notes"
droid exec -s <id> "query"	既存セッションをexecモードで再開	droid exec -s session-123 "continue"
droid exec --list-tools	利用可能なツールをリストして終了	droid exec --list-tools
droid update	CLIを最新バージョンに手動更新	droid update

​

CLIフラグ

コマンドラインフラグでdroidの動作をカスタマイズ：

フラグ	説明	例
-f, --file <path>	ファイルからプロンプトを読み込み	droid exec -f plan.md
-m, --model <id>	特定のモデルIDを選択	droid exec -m claude-opus-4-7
-s, --session-id <id>	既存セッションを継続	droid exec -s session-abc123
--auto <level>	自律レベルを設定（low、medium、high）	droid exec --auto medium "run tests"
--enabled-tools <ids>	特定のツールを強制有効化（カンマまたはスペース区切り）	droid exec --enabled-tools ApplyPatch,Bash
--disabled-tools <ids>	この実行で特定のツールを無効化	droid exec --disabled-tools execute-cli
--list-tools	利用可能なツールを表示して終了	droid exec --list-tools
-o, --output-format <format>	出力形式（text、json、stream-json、stream-jsonrpc）	droid exec -o json "document API"
--input-format <format>	入力形式（マルチターン用のstream-jsonrpc）	droid exec --input-format stream-jsonrpc -o stream-jsonrpc
-r, --reasoning-effort <level>	推論努力レベルを上書き（off、none、low、medium、high）	droid exec -r high "debug flaky test"
--spec-model <id>	仕様計画に別のモデルIDを使用	droid exec --spec-model claude-sonnet-4-6
--spec-reasoning-effort <level>	specモードの推論努力を上書き	droid exec --use-spec --spec-reasoning-effort high
--use-spec	仕様モードで開始（実行前に計画）	droid exec --use-spec "add user profiles"
--skip-permissions-unsafe	すべての許可プロンプトをスキップ（⚠️ 極度に注意して使用）	droid exec --skip-permissions-unsafe
--cwd <path>	特定の作業ディレクトリから実行	droid exec --cwd ../service "run tests"
-w, --worktree [name]	隔離された Gitワークツリー でセッションを実行	droid --worktree fix-bug
--tag <spec>	セッションタグ（名前またはJSON、繰り返し可能）	droid exec --tag code-review
--log-group-id <id>	ログフィルタリング用のロググループID	droid exec --log-group-id grp-123
-v, --version	CLIバージョンを表示	droid -v
-h, --help	ヘルプ情報を表示	droid --help

スクリプトや自動化には--output-format jsonを使用して、droidの応答をプログラム的に解析できます。

​

自律レベル

droid execは階層化された自律性を使用して、エージェントが実行できる操作を制御します。環境が安全な場合にのみアクセスレベルを上げてください。

レベル	想定用途	主要な許可事項
（デフォルト）	読み取り専用偵察	ファイル読み取り、git diff、環境検査
--auto low	安全な編集	ファイル作成・編集、フォーマッター実行、非破壊的コマンド
--auto medium	ローカル開発	依存関係インストール、ビルド・テスト、ローカルgitコミット
--auto high	CI/CD & オーケストレーション	Git push、デプロイスクリプト、長時間実行操作
--skip-permissions-unsafe	隔離サンドボックス専用	すべてのガードレールを削除（⚠️ 使い捨てコンテナでのみ使用）

例：

# Default (read-only)
droid exec "Analyze the auth system and create a plan"

# Low autonomy - safe edits
droid exec --auto low "Add JSDoc comments to all functions"

# Medium autonomy - development work
droid exec --auto medium "Install deps, run tests, fix issues"

# High autonomy - deployment
droid exec --auto high "Run tests, commit, and push changes"

--skip-permissions-unsafeはすべての安全性チェックを削除します。Dockerコンテナなどの分離された環境でのみ使用してください。

​

モデルID

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

どのモデルをどのタスクに使用するかの詳細なガイダンスについては、モデルの選択をご覧ください。

​

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

​

Bashモード

入力が空の時に!を押すとbashモードを切り替えます。bashモードでは、コマンドはAIの解釈なしにシェルで直接実行されます。git statusの確認やnpm testの実行など、素早い操作に便利です。

• オンに切り替え: !を押す（入力が空の時）
• コマンドの実行: 任意のシェルコマンドを入力してEnterを押す
• オフに切り替え: Escを押して通常のAIチャットモードに戻る

bashモードがアクティブの時、プロンプトが>から$に変わります。

​

スラッシュコマンド

droidをインタラクティブモードで実行している時に利用できます。プロンプトでコマンドを入力してください：

コマンド	説明
/account	ブラウザでFactoryアカウント設定を開く
/billing	請求設定の表示と管理
/bg-process	バックグラウンドプロセスの管理
/bug [title]	セッションデータとログを含むバグレポートの作成
/clear	新しいセッションを開始（/newのエイリアス）
/commands	カスタムスラッシュコマンドの管理
/compress [prompt]	セッションを圧縮し、要約と共に新しいセッションに移動
/cost	トークン使用統計の表示
/create-skill	現在のセッションから再利用可能なスキルを作成
/droids	カスタムDroidの管理
/missions	Factory Missionsに入る
/favorite	現在のセッションをお気に入りにマーク
/fork	すべてのメッセージを含む現在のセッションを新しいセッションに複製
/generate_blog	セマンティックdiffブログ投稿の生成
/help	利用可能なスラッシュコマンドの表示
/hooks	ライフサイクルフックの管理
/ide	IDE統合の設定
/install-code-review	自動コードレビューの設定
/login	Factoryにサインイン
/logout	Factoryからサインアウト
/mcp	Model Context Protocolサーバーの管理
/mission	Mission Controlを開く
/missions	再開するFactory Missionsの一覧と選択
/model	セッション中にAIモデルを切り替え
/new	新しいセッションを開始
/plugins	プラグインとマーケットプレイスの管理
/quit	droidを終了（エイリアス: exit、またはCtrl+Cを押す）
/readiness-report	準備状況レポートの生成
/rename	現在のセッション名を変更
/review	AI支援によるコードレビューワークフローの開始
/rewind-conversation	セッション内の最近の変更を取り消し
/sessions	過去のセッションの一覧と選択
/settings	アプリケーション設定の構成
/share	組織とセッションを共有
/skills	スキルの管理と呼び出し
/status	現在のDroidの状態と設定を表示
/statusline	カスタムステータスラインの設定
/terminal-setup	Shift+Enter用のターミナルキーバインドの設定
/wrapped	Droidの使用統計を表示

スラッシュコマンドの詳細については、インタラクティブモードのドキュメントをご覧ください。

​

Gitワークツリー

-w, --worktree [name] を使うと、ネイティブな Git worktree の中でセッションを実行できます。これにより、同じリポジトリの複数ブランチをファイル競合なしで並列に扱えます。このフラグは droid（インタラクティブ）と droid exec の両方で利用できます。

各ワークツリーは、リポジトリの隣接ディレクトリ（../<repo>-wt-<branch>/）に作成され、独立したチェックアウトと専用ブランチを持ちます。

ブランチ命名:

• --worktree（値なし） — <current-branch>-wt という名前のブランチでワークツリーを作成または再利用します。
• --worktree <name> — <name> をブランチ名として使用します。ブランチがすでに存在する場合はそのワークツリーでチェックアウトされ、存在しない場合は HEAD から作成されます。
• 対象ブランチが別のワークツリーですでにチェックアウトされている場合、コマンドは明確なエラーを表示して失敗します。

例:

# Interactive: derive branch from current branch (creates <current>-wt)
droid --worktree

# Interactive: explicit branch name
droid -w fix-auth-bug "start debugging the login flow"

# Headless: isolate an automated task on its own branch
droid exec --worktree refactor-tests --auto medium "migrate jest suites to vitest"

# Run two parallel sessions on the same repo, each on its own branch
droid --worktree feature-a &
droid --worktree feature-b &

セッションのライフサイクル:

• インタラクティブモード — セッション終了後もワークツリーは保持されるため、作業の再開、変更の確認、ブランチの push を行えます。
• droid exec モード — 終了時に、クリーンなワークツリー（未コミット変更なし）は自動的に削除されます。未コミット変更があるワークツリーは保持され、作業を確認できるようそのパスが表示されます。
• 基盤となる Git ブランチは Droid によって削除されません。クリーンアップ時に削除されるのはワークツリーディレクトリだけです。

--worktree が有効な場合、Droid はワークツリーディレクトリ内で完全に動作します。後続の コマンド（テスト、ビルド、インストール）は元のリポジトリルートではなく、そのディレクトリから 実行してください。新しく作成したワークツリーには依存関係（たとえば node_modules）がまだ インストールされていない場合があるため、ビルドやテストがモジュール不足で失敗したときはセットアップしてください。

​

MCPコマンドリファレンス

/mcpスラッシュコマンドは、MCPサーバーの閲覧と管理のためのインタラクティブマネージャーUIを開きます。

クイックスタート: /mcpと入力し、**「レジストリから追加」**を選択して40以上の事前設定されたサーバー（Linear、Sentry、Notion、Stripe、Vercelなど）を閲覧します。サーバーを選択し、必要に応じて認証を行えば準備完了です。

スクリプト化と自動化のためのCLIコマンド：

droid mcp add <name> <url> --type http    # Add HTTP server
droid mcp add <name> "<command>"          # Add stdio server
droid mcp remove <name>                   # Remove a server

MCP設定で、完全なレジストリリスト、CLIオプション（--env、--header）、設定ファイル、およびユーザーとプロジェクト設定のレイヤリング動作について確認してください。

​

認証

1. app.factory.ai/settings/api-keysでAPIキーを生成します
2. 環境変数を設定します：

macOS/Linux

export FACTORY_API_KEY=fk-...

変数を保持する ためには、長期利用のためにシェルプロファイル（~/.bashrc、~/.zshrc、またはPowerShell $PROFILE）に設定してください。

APIキーをソース管理にコミットしないでください。環境変数またはセキュアなシークレット管理を使用してください。

​

終了コード

コード	意味
0	成功
1	一般的な実行時エラー
2	無効なCLI引数/オプション

​

一般的なワークフロー

​

コードレビュー

# Local review workflow
> /review

# Analysis via exec (non-interactive)
droid exec "Review this PR for security issues"

# With modifications
droid exec --auto low "Review code and add missing type hints"

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

​

テストとデバッグ

# Investigation
droid exec "Analyze failing tests and explain root cause"

# Fix and verify
droid exec --auto medium "Fix failing tests and run test suite"

​

リファクタリング

# Planning
droid exec "Create refactoring plan for auth module"

# Execution
droid exec --auto low --use-spec "Refactor auth module"

​

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

# Work on two branches of the same repo at the same time, each in its own worktree
droid --worktree feature-a &
droid --worktree feature-b &

# Fan out headless tasks across branches without clobbering each other's files
droid exec -w migration-step-1 --auto medium "apply codemod A" &
droid exec -w migration-step-2 --auto medium "apply codemod B" &
wait

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

​

CI/CD統合

# GitHub Actions example
- name: Run Droid Analysis
  env:
    FACTORY_API_KEY: ${{ secrets.FACTORY_API_KEY }}
  run: |
    droid exec --auto medium -f .github/prompts/deploy.md

​

関連項目

• クイックスタートガイド - Droid CLIの使い始め
• インタラクティブモード - ショートカット、入力モード、機能
• モデルの選択 - モデル選択のガイダンス
• 設定 - 設定オプション
• カスタムコマンド - 独自のショートカットを作成
• カスタムDroid - 専門的なエージェントを構築
• Droid Exec概要 - 詳細な自動化ガイド
• MCP設定 - 外部ツール統合