CLIリファレンス - Factory Documentation

インストール

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

irm https://app.factory.ai/cli/windows | iex

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

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

CLIコマンド

コマンド	説明	例
`droid`	インタラクティブREPLを開始	`droid`
`droid "query"`	初期プロンプトでREPLを開始	`droid "explain this project"`
`droid --resume [sessionId]`	セッションを再開（指定がない場合は最後に変更したものを使用）。エイリアス: `-r`	`droid --resume`
`droid --fork <sessionId>`	セッションを fork して新しいコピーで再開	`droid --fork session-abc123`
`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 search "query"`	ローカルセッション横断検索（メッセージ、ドキュメント、ツール結果）。エイリアス: `droid find`	`droid search "auth bug"`
`droid mcp add <name> <url>`	MCP サーバーを追加	`droid mcp add api https://api.example.com/mcp --type http`
`droid mcp remove <name>`	MCP サーバーを削除	`droid mcp remove linear`
`droid plugin install <plugin>`	プラグインをインストール。エイリアス: `droid plugin i`	`droid plugin install factory/code-review`
`droid plugin uninstall <plugin>`	プラグインをアンインストール。エイリアス: `droid plugin remove`	`droid plugin uninstall factory/code-review`
`droid plugin update <plugin>`	プラグインを最新バージョンに更新	`droid plugin update factory/code-review`
`droid plugin list`	インストール済みのプラグインを一覧表示	`droid plugin list`
`droid plugin marketplace`	プラグインマーケットプレイスを管理	`droid plugin marketplace`
`droid computer register [name]`	このマシンを Bring-Your-Own-Machine (BYOM) コンピューターとして登録	`droid computer register laptop`
`droid computer remove`	このマシンの BYOM 登録を削除	`droid computer remove`
`droid computer list`	登録済みの BYOM コンピューターを一覧表示	`droid computer list`
`droid computer ssh <name>`	登録済みの BYOM コンピューターに SSH 接続	`droid computer ssh laptop`
`droid daemon`	Factory デーモンサーバーを実行	`droid daemon`
`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, --resume [sessionId]`	前回のセッションを再開。インタラクティブモードでは `-r` は `--resume`、`droid exec` では `-r` は `--reasoning-effort` にマッピングされます。	`droid -r`
`-r, --reasoning-effort <level>`	推論努力レベルを上書き（`off`、`none`、`low`、`medium`、`high`）。`droid exec` では `-r` はこのフラグにマッピングされます。	`droid exec -r high "debug flaky test"`
`--spec-model <id>`	仕様計画に別のモデルIDを使用	`droid exec --spec-model claude-opus-4-7`
`--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`
`--fork <id>`	既存セッションを fork して新しいコピーで再開	`droid exec --fork session-abc123`
`--mission`	`droid exec` をミッションモード（マルチエージェントオーケストレーション）で実行	`droid exec --mission -f mission.md`
`--worker-model <id>`	ミッションのワーカーエージェントが使用するモデル	`droid exec --mission --worker-model claude-sonnet-4-6`
`--worker-reasoning-effort <level>`	ミッションのワーカーエージェントの推論努力（`off`、`none`、`low`、`medium`、`high`）	`droid exec --mission --worker-reasoning-effort medium`
`--validator-model <id>`	ミッションのバリデーターエージェントが使用するモデル	`droid exec --mission --validator-model claude-opus-4-7`
`--validator-reasoning-effort <level>`	ミッションのバリデーターエージェントの推論努力	`droid exec --mission --validator-reasoning-effort high`
`--append-system-prompt <text>`	システムプロンプトの末尾にカスタムテキストを追加	`droid --append-system-prompt "Always run tests."`
`--append-system-prompt-file <path>`	システムプロンプトの末尾にファイルの内容を追加	`droid --append-system-prompt-file .factory/system.md`
`-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)を参照してください。どのモデルをどのタスクに使用するかの詳細なガイダンスについては、モデルの選択をご覧ください。

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

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

インタラクティブREPLは、ナビゲーション、オーバーレイ、入力制御のための豊富なキーボードショートカットをサポートしています：

ショートカット	アクション
`Ctrl+C`	現在の操作をキャンセル / エージェントを中断。すばやく2回押すと終了
`Ctrl+Z`	プロセスをサスペンド（Unixのみ）。`fg` で再開
`Ctrl+O`	詳細なトランスクリプトビュー（メッセージ詳細）の表示を切り替え
`Ctrl+T`	Mission Control オーバーレイを切り替え（オーケストレーターセッションのみ）
`Ctrl+N`	利用可能なモデルを順に切り替え（チャット入力中）
`Ctrl+L`	自律レベルを順に切り替え（チャット入力中）
`Ctrl+Y`	`/btw` のスクロールビュー（サイド質問履歴）を切り替え
`Ctrl+J`	変更履歴の表示を切り替え（非表示 / 復元）
`Ctrl+E`	承認の詳細ビューを切り替え
`Ctrl+V`	クリップボードから画像を添付として貼り付け
`Tab`	推論努力レベルを順に切り替え（`low` → `medium` → `high` → `off`）
`Shift+Tab`	インタラクションモードを順に切り替え（Auto → Spec → Mission）
`@`	ファイルパスの自動補完 — `@` を入力するとファイルのあいまい検索が起動
`Up` / `Down`	入力履歴を移動（過去に送信したメッセージを順に切り替え）
`Double Escape`	2 回目の押下で入力ドラフトをクリア、3 回目の Escape で巻き戻しメニューを開く
`?`	ヘルプポップアップを切り替え（入力が空の時）
`Ctrl+/`	ヘルプポップアップを切り替え（入力に内容があっても動作）
`Ctrl+A`	カーソルを行頭に移動
`Ctrl+W`	カーソルの前の単語を削除
`Ctrl+K`	カーソルから行末まで削除
`Ctrl+U`	カーソルから行頭まで削除
`Ctrl+D`	添付されたすべての画像をクリア、画像がない場合は次の文字を前方削除
`Ctrl+R`	ハイライト中のセッション名を変更（`/sessions` リストビュー内）
`Ctrl+X`	ハイライト中のセッションをアーカイブ（`/sessions` リストビュー内）
`Alt+Up`	トランスクリプトを上にスクロール（任意のターンに移動）
`Alt+Down`	トランスクリプトを下にスクロール（任意のターンに移動）
`Alt+PageUp`	前のユーザーターンまでトランスクリプトを上にスクロール
`Alt+PageDown`	次のユーザーターンまでトランスクリプトを下にスクロール
`Escape`	アクティブなオーバーレイまたはメニューを閉じる
`Shift+Enter`	チャット入力に改行を挿入（複数行編集）
`!`	bashモードを切り替え（入力が空の時）

/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

未対応の図種類（たとえば gantt、pie、mindmap、timeline、journey、gitGraph）は、生の Mermaid ソースと外部で図を表示するためのリンクの表示にフォールバックします。

スラッシュコマンド

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

コマンド	説明
`/account`	ブラウザでFactoryアカウント設定を開く
`/billing`	請求設定の表示と管理
`/btw <question>`	メイントランスクリプトを汚さずにサイド質問を行う
`/bug [title]`	セッションデータとログを含むバグレポートの作成
`/clear`	新しいセッションを開始（`/new`のエイリアス）
`/commands`	カスタムスラッシュコマンドの管理
`/compress [prompt]`	セッションを圧縮し、要約と共に新しいセッションに移動
`/context`	プログレスバー付きでコンテキストウィンドウの使用状況を表示
`/copy`	プロンプト、応答、ターン範囲、またはセッションIDをコピー
`/cost`	使用統計の表示
`/create-skill`	現在のセッションから再利用可能なスキルを作成
`/cwd <path>`	セッションの作業ディレクトリを変更
`/diagnostics`	設定の構成エラーを表示
`/droids`	カスタムDroidの管理
`/missions`	Mission モードに入る
`/fast`	現在のモデルで fast モードを有効化（無効化は `/fast off`）
`/favorite`	現在のセッションをお気に入りにマーク
`/fork`	すべてのメッセージを含む現在のセッションを新しいセッションに複製
`/help`	利用可能なスラッシュコマンドの表示
`/hooks`	ライフサイクルフックの管理
`/ide`	IDE統合の設定
`/install-code-review`	自動コードレビューの設定
`/install-slack-app`	Slack 連携をインストール / 接続
`/language <locale>`	TUI 表示言語を切り替え
`/limits`	トークン使用上限と超過時の挙動を管理
`/login`	Factoryにサインイン
`/logout`	Factoryからサインアウト
`/mcp`	Model Context Protocolサーバーの管理
`/model`	セッション中にAIモデルを切り替え
`/new`	新しいセッションを開始
`/plugins`	プラグインとマーケットプレイスの管理
`/quit`	droidを終了（エイリアス: `exit`、またはCtrl+Cを押す）
`/readiness-fix`	最新レポートで失敗しているエージェント準備シグナルを修正
`/readiness-report`	準備状況レポートの生成
`/rename`	現在のセッション名を変更
`/review`	AI支援によるコードレビューワークフローの開始
`/rewind-conversation`	セッション内の最近の変更を取り消し
`/sessions`	過去のセッションの一覧と選択
`/settings`	アプリケーション設定の構成
`/setup-incident-response`	インシデント対応チャンネル向けの Slack 自動実行をセットアップ
`/share`	組織とセッションを共有
`/skills`	スキルの管理と呼び出し
`/stats [period]`	使用統計の表示（相対期間、日付範囲に対応）
`/status`	現在のDroidの状態と設定を表示
`/statusline`	カスタムステータスラインの設定
`/terminal-setup`	Shift+Enter用のターミナルキーバインドの設定
`/themes`	カラーテーマを選択

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

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）がまだインストールされていない場合があるため、ビルドやテストがモジュール不足で失敗したときはセットアップしてください。

サブコマンドのフラグ

上記のグローバルフラグに加えて、いくつかの droid サブコマンドは独自のフラグを受け付けます。

`droid search` のフラグ

フラグ	説明	例
`--kind <kind>`	エントリ種別でフィルタ: `message_text`、`document`、`tool_use`、`tool_result`、または `all`	`droid search "auth" --kind document`
`--limit-sessions <n>`	返却するセッションの最大数	`droid search "auth" --limit-sessions 5`
`--limit-hits <n>`	セッション・種別ごとに返すマッチの最大数	`droid search "auth" --limit-hits 3`
`--context-chars <n>`	各マッチ周辺に表示するコンテキストの文字数	`droid search "auth" --context-chars 200`
`--json`	結果を JSON で出力	`droid search "auth" --json`
`--reindex`	検索キャッシュを破棄してローカルインデックスを再構築	`droid search "auth" --reindex`

`droid mcp add` のフラグ

フラグ	説明	例
`--type <type>`	サーバーのトランスポート: `http`（Streamable HTTP）、`sse`（レガシーな HTTP+SSE）、または `stdio`（ローカル）	`droid mcp add api https://api.example.com/mcp --type http`
`--env <KEY=VALUE>`	stdio サーバー用の環境変数を設定（繰り返し可能）	`droid mcp add gh "gh-mcp" --type stdio --env GH_TOKEN=$GH_TOKEN`
`--header <KEY: VALUE>`	リモートサーバー用の HTTP ヘッダーを追加（繰り返し可能）	`droid mcp add api https://api.example.com/mcp --type http --header "Authorization: Bearer $TOKEN"`

`droid plugin` のフラグ

フラグ	説明	例
`-s, --scope <scope>`	インストール範囲: `user`（デフォルト）または `project`	`droid plugin install factory/code-review --scope project`

`droid computer register` のフラグ

フラグ	説明	例
`-y, --yes`	対話プロンプトをスキップして登録のデフォルトを受け入れる	`droid computer register laptop -y`

MCPコマンドリファレンス

/mcpスラッシュコマンドは、MCPサーバーの閲覧と管理のためのインタラクティブマネージャーUIを開きます。 クイックスタート: /mcpと入力し、**「レジストリから追加」**を選択して40以上の事前設定されたサーバー（Linear、Sentry、Notion、Stripe、Vercelなど）を閲覧します。サーバーを選択し、必要に応じて認証を行えば準備完了です。スクリプト化と自動化のためのCLIコマンド：

droid mcp add <name> <url> --type http    # HTTP（Streamable）サーバーを追加
droid mcp add <name> <url> --type sse     # レガシーな HTTP+SSE サーバーを追加
droid mcp add <name> "<command>"          # stdio サーバーを追加
droid mcp remove <name>                   # サーバーを削除

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

認証

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

export FACTORY_API_KEY=fk-...

$env:FACTORY_API_KEY="fk-..."

set 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

​インストール

​CLIコマンド

​CLIフラグ

​自律レベル

​モデルID

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

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

​Bashモード

​Mermaid 図のレンダリング

​スラッシュコマンド

​Gitワークツリー

​サブコマンドのフラグ

​droid search のフラグ

​droid mcp add のフラグ

​droid plugin のフラグ

​droid computer register のフラグ

​MCPコマンドリファレンス

​認証

​終了コード

​一般的なワークフロー

​コードレビュー

​テストとデバッグ

​リファクタリング

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

​CI/CD統合

​関連項目

インストール

CLIコマンド

CLIフラグ

自律レベル

モデルID

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

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

Bashモード

Mermaid 図のレンダリング

スラッシュコマンド

Gitワークツリー

サブコマンドのフラグ

`droid search` のフラグ

`droid mcp add` のフラグ

`droid plugin` のフラグ

`droid computer register` のフラグ

MCPコマンドリファレンス

認証

終了コード

一般的なワークフロー

コードレビュー

テストとデバッグ

リファクタリング

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

CI/CD統合

関連項目