All apps/Droid

Droid

factory-droid

Use the Droid CLI to run Factory from your terminal, editor, tests, and Git workflow.

Runs as droid|macOS, Linux, Windows|factory.ai

Command form

ai-draft · 2 tasks · 14 fields

Start the Droid coding agent with an optional first prompt, or run a task headlessly with the exec subcommand.

Opens the form; the finished command lands at your prompt, unrun
otty gui factory-droid
Chat with DroidExample values, fixed in this page — nothing here reaches a terminal
Basic
Prompt
string
Advanced
Append to system prompt
string
Append system prompt from file
file
ParametersOnly these flags are editable in the form
Prompt
Initial prompt. Leave empty to start with an empty chat.
string · positional 0
Append to system prompt
string
--append-system-prompt
Append system prompt from file
path
--append-system-prompt-file

droid exec

Run a task headlessly

Run one prompt non-interactively with droid exec. Mission mode, tool allow/deny lists, spec mode and session tagging are left out.

Run a task headlesslyExample values, fixed in this page — nothing here reaches a terminal
Basic
Prompt*
string
Model ID
string
Output format
3 choicesenum
Working directory
directory
TasksEach one presets the form for one job
Read-only analysis
promptmodeloutput_formatcwd
Make changes (medium autonomy)
promptmodelautocwd
ParametersOnly these flags are editable in the form
Prompt
Leave empty when reading the prompt from a file.
string · positional 0
Prompt file
path
--file-f
Model ID
string
--model-m
Autonomy level
Omit for read-only. Low allows safe edits, medium local development, high push and deploy.
enum
--autolowmediumhigh
Output format
enum
--output-format-otextjsonstream-json
Continue session
string
--session-id-s
Working directory
path
--cwd
Reasoning effort
Valid levels depend on the model.
string
--reasoning-effort-r
Plan first (spec mode)
boolean
--use-spec
List available tools
boolean
--list-tools
Skip all permission prompts
Unsafe: only in disposable sandboxes.
boolean
--skip-permissions-unsafe
SourcesEvery flag above is checked against these
docs
From https://docs.factory.ai/reference/cli-reference (Droid CLI commands and flags tables) droid | Start interactive REPL | droid | droid "query" | Start REPL with initial prompt | droid "explain this project" | droid exec "query" | Execute task without interactive mode | droid exec "summarize src/auth" | droid exec -f prompt.md | Load prompt from file | dro…
manual2026-10-27

docs.factory.ai

docs
From https://docs.factory.ai/reference/cli-reference (Droid CLI commands and flags tables) droid | Start interactive REPL | droid | droid "query" | Start REPL with initial prompt | droid "explain this project" | droid exec "query" | Execute task without interactive mode | droid exec "summarize src/auth" | droid exec -f prompt.md | Load prompt from file | dro…
manual2026-10-27

docs.factory.ai

Before it fills your prompt, Otty checks the installed droid against its version. A form that does not match your version is not offered.