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

Documentation Index

Fetch the complete documentation index at: https://factory-docs-auto-sync-jp-docs.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
インストール

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>特定のモデルを選択（モデルIDを参照）droid exec -m claude-opus-4-6
-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-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
スクリプトや自動化には--output-format jsonを使用して、droidの応答をプログラム的に解析できます。

​
自律レベル

droid execは階層化された自律性を使用して、エージェントが実行できる操作を制御します。環境が安全な場合にのみアクセスレベルを上げてください。
レベル想定用途主要な許可事項
（デフォルト）読み取り専用偵察ファイル読み取り、git diff、環境検査
--auto low安全な編集ファイル作成・編集、フォーマッター実行、非破壊的コマンド
--auto mediumローカル開発依存関係インストール、ビルド・テスト、ローカルgitコミット
--auto highCI/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名前推論サポートデフォルト推論
claude-opus-4-7Claude Opus 4.7あり (Off/Low/Medium/High/Max)high
claude-opus-4-6Claude Opus 4.6あり (Off/Low/Medium/High/Max)high
claude-opus-4-6-fastClaude Opus 4.6 Fastあり (Off/Low/Medium/High/Max)high
claude-opus-4-5-20251101Claude Opus 4.5あり (Off/Low/Medium/High)off
claude-sonnet-4-6Claude Sonnet 4.6あり (Off/Low/Medium/High/Max)high
claude-sonnet-4-5-20250929Claude Sonnet 4.5あり (Off/Low/Medium/High)off
claude-haiku-4-5-20251001Claude Haiku 4.5あり (Off/Low/Medium/High)off
gpt-5.5GPT-5.5あり (None/Low/Medium/High/Extra High)medium
gpt-5.5-fastGPT-5.5 Fastあり (None/Low/Medium/High/Extra High)medium
gpt-5.5-proGPT-5.5 Proあり (None/Low/Medium/High/Extra High)medium
gpt-5.4GPT-5.4あり (None/Low/Medium/High/Extra High)medium
gpt-5.3-codexGPT-5.3-Codexあり (None/Low/Medium/High/Extra High)medium
gpt-5.2-codexGPT-5.2-Codexあり (None/Low/Medium/High/Extra High)medium
gpt-5.2GPT-5.2あり (Off/Low/Medium/High/Extra High)low
gemini-3.1-pro-previewGemini 3.1 Proあり (Low/Medium/High)high
gemini-3-flash-previewGemini 3 Flashあり (Minimal/Low/Medium/High)high
glm-5.1Droid Core (GLM-5.1)Noneのみnone
kimi-k2.5Droid Core (Kimi K2.5)Noneのみnone
kimi-k2.6Droid Core (Kimi K2.6)あり (Off/High)high
minimax-m2.7Droid Core (MiniMax M2.7)あり (Low/Medium/High)high
BYOKで設定されたカスタムモデルはcustom:<alias>の形式を使用します。 どのモデルをどのタスクに使用するかの詳細なガイダンスについては、モデルの選択をご覧ください。

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

​
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の管理
/missionsMissionモードに入る
/favorite現在のセッションをお気に入りにマーク
/forkすべてのメッセージを含む現在のセッションを新しいセッションに複製
/generate_blogセマンティックdiffブログ投稿の生成
/help利用可能なスラッシュコマンドの表示
/hooksライフサイクルフックの管理
/ideIDE統合の設定
/install-code-review自動コードレビューの設定
/loginFactoryにサインイン
/logoutFactoryからサインアウト
/mcpModel Context Protocolサーバーの管理
/missionMission Controlを開く
/missions再開するミッションの一覧と選択
/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の使用統計を表示
スラッシュコマンドの詳細については、インタラクティブモードのドキュメントをご覧ください。

​
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. 環境変数を設定します：
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"

​
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

​
関連項目