メインコンテンツへスキップ

​
インストール

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 updateCLIを最新バージョンに手動更新droid update

​
CLIフラグ

コマンドラインフラグでdroidの動作をカスタマイズできます：
フラグ説明例
-f, --file <path>ファイルからプロンプトを読み込みdroid exec -f plan.md
-m, --model <id>特定のモデルを選択 （model IDsを参照）droid exec -m claude-opus-4-6
-s, --session-id <id>既存のセッションを続行droid exec -s session-abc123
--auto <level>autonomy 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-json、マルチターン用は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>仕様プランニング用に別のモデルを使用droid exec --spec-model claude-sonnet-4-5-20250929
--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"
--tag <spec>セッションタグ（名前またはJSON、繰り返し可能）droid exec --tag code-review
--log-group-id <id>ログフィルタリング用のロググループIDdroid exec --log-group-id grp-123
-v, --versionCLIバージョンを表示droid -v
-h, --helpヘルプ情報を表示droid --help
Use --output-format json for scripting and automation, allowing you to parse droid’s responses programmatically.

​
自律性レベル

droid execは段階的な自律性を使用して、エージェントが実行できる操作を制御します。環境が安全な場合のみアクセスレベルを上げてください。
レベル用途注目すべき許可事項
(デフォルト)読み取り専用の偵察ファイル読み取り、gitの差分、環境検査
--auto low安全な編集ファイルの作成/編集、フォーマッター実行、非破壊的コマンド
--auto mediumローカル開発依存関係のインストール、ビルド/テスト、ローカルgitコミット
--auto highCI/CDとオーケストレーションgitプッシュ、デプロイスクリプト、長時間実行操作
--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 removes all safety checks. Use only in isolated environments like Docker containers.

​
利用可能なモデル

モデルID名前推論サポートデフォルト推論
claude-opus-4-6Claude Opus 4.6Yes (Off/Low/Medium/High/Max)high
claude-opus-4-6-fastClaude Opus 4.6 FastYes (Off/Low/Medium/High/Max)high
claude-opus-4-5-20251101Claude Opus 4.5Yes (Off/Low/Medium/High)off
claude-sonnet-4-6Claude Sonnet 4.6Yes (Off/Low/Medium/High/Max)high
claude-sonnet-4-5-20250929Claude Sonnet 4.5Yes (Off/Low/Medium/High)off
claude-haiku-4-5-20251001Claude Haiku 4.5Yes (Off/Low/Medium/High)off
gpt-5.4GPT-5.4Yes (None/Low/Medium/High/Extra High)medium
gpt-5.3-codexGPT-5.3-CodexYes (None/Low/Medium/High/Extra High)medium
gpt-5.2-codexGPT-5.2-CodexYes (None/Low/Medium/High/Extra High)medium
gpt-5.2GPT-5.2Yes (Off/Low/Medium/High/Extra High)low
gemini-3.1-pro-previewGemini 3.1 ProYes (Low/Medium/High)high
gemini-3-flash-previewGemini 3 FlashYes (Minimal/Low/Medium/High)high
glm-4.7Droid Core (GLM-4.7)None onlynone
glm-5Droid Core (GLM-5)None onlynone
kimi-k2.5Droid Core (Kimi K2.5)None onlynone
minimax-m2.5Droid Core (MiniMax M2.5)Yes (Low/Medium/High)high
BYOK経由で設定されたカスタムモデルは次の形式を使用：custom:<alias> 異なるタスクに対してどのモデルを使用するかの詳細なガイダンスについてはChoosing Your Modelを参照してください。

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

​
bashモード

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

​
スラッシュコマンド

droidをインタラクティブモードで実行している時に利用可能です。プロンプトでコマンドを入力してください：
コマンド説明
/accountFactoryアカウントセッティングをブラウザで開く
/billing請求設定を表示・管理
/bg-processバックグラウンドプロセスを管理
/bug [title]セッションデータとログでバグレポートを作成
/clear新しいセッションを開始（/newのエイリアス）
/commandsカスタムスラッシュコマンドを管理
/compress [prompt]セッションを圧縮して要約付きで新しいセッションに移動
/costトークン使用統計を表示
/create-skill現在のセッションから再利用可能なスキルを作成
/droidsカスタムdroidを管理
/enter-missionMissionモードに入る
/favorite現在のセッションをお気に入りにマーク
/fork現在のセッションをすべてのメッセージと共に新しいセッションに複製
/generate_blogセマンティック差分ブログ投稿を生成
/help利用可能なスラッシュコマンドを表示
/hooksライフサイクルフックを管理
/ideIDE統合を設定
/install-github-appFactory GitHub Appをインストール
/loginFactoryにサインイン
/logoutFactoryからサインアウト
/mcpModel Context Protocolサーバーを管理
/missionMission Controlを開く
/missions再開するmissionを一覧表示・選択
/modelセッション途中でAIモデルを切り替え
/new新しいセッションを開始
/pluginsプラグインとマーケットプレースを管理
/quitdroidを終了（エイリアス：exit、またはCtrl+Cを押す）
/readiness-reportレディネスレポートを生成
/rename現在のセッション名を変更
/reviewAI搭載のコードレビューワークフローを開始
/rewind-conversationセッション内の最近の変更を取り消し
/sessions以前のセッションを一覧表示・選択
/settingsアプリケーション設定を構成
/shareセッションを組織と共有
/skillsスキルを管理・呼び出し
/status現在のdroidのステータスと設定を表示
/statuslineカスタムステータス行を設定
/terminal-setupShift+Enter用のターミナルキーバインドを設定
/wrappedDroidの使用統計を表示
スラッシュコマンドの詳細情報については、interactive mode documentationを参照してください。

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

/mcpスラッシュコマンドは、MCPサーバーの閲覧と管理のためのインタラクティブマネージャーUIを開きます。 クイックスタート: /mcpと入力して**「Add from Registry」**を選択し、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
完全なレジストリリスト、CLIオプション（--env、--header）、設定ファイル、およびユーザー対プロジェクト設定の階層化の仕組みについてはMCP Configurationを参照してください。

​
認証

  1. app.factory.ai/settings/api-keysでAPIキーを生成
  2. 環境変数を設定：
export FACTORY_API_KEY=fk-...
長期使用のために、シェルプロファイル（~/.bashrc、~/.zshrc、またはPowerShell $PROFILE）に変数を永続化してください。
Never commit API keys to source control. Use environment variables or secure secret management.

​
終了コード

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

​
一般的なワークフロー

​
コードレビュー

# Interactive 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"
レビューの種類、ワークフロー、ベストプラクティスの詳細なガイダンスについてはCode Review documentationを参照してください。

​
テストとデバッグ

# 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"

​
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

​
参照