Reference · Reference
Factory Droid CLI Cheat Sheet
Search and copy Factory Droid CLI commands by category: CLI commands, flags, slash commands, keyboard shortcuts, and settings.
Last updated:
Verified against: v0.209.x (tested with v0.209.0) | Updated September 2026
How to use
Expand how to useCollapse how to use
- 1
Search commands
Type a keyword to filter by command name, description, options, and examples at once.
- 2
Filter by category
Switch between CLI commands, flags, slash commands, shortcuts, and settings to find what you need quickly.
- 3
One-click copy
Use the copy button to copy a command to your clipboard and paste it straight into your terminal or Droid session.
Latest updates
Recent highlights from the Droid CLI changelog. See the full history at the bottom of this page.
v0.209.x (September 1, 2026)
- Verified against v0.209.0 (2026-09-01). You can now archive the current session from chat with /archive or Ctrl+X and restore it from the Archived tab in /sessions (both are already listed here). Sessions with no model selected now default to GPT-5.6 Sol, and the CLI starts on time when organization settings load slowly, applying them once they arrive
- Bug fixes: text selected in a diff no longer clears when the session sidebar updates, and the environment panel stays visible while repository details load or refresh. Opening a file link now centers the target line (all app-side), and running out of credits suggests an available Droid Core model instead of a retired one
- A full re-check of the official docs (cli-reference and settings) found no CLI commands, flags, slash commands, shortcuts, or settings added, removed, or changed (still 178 items listed)
v0.208.x (August 29, 2026)
- Verified against v0.208.1 (2026-08-29). In v0.208.0, organization owners can require people on verified email domains to join by invitation instead of creating a new organization. Screenshots, diagrams, and tables keep fine detail when Droid resizes images, /new and /clear show progress while the next session is created, You.com joined the MCP server registry, and built-in slash commands run immediately instead of waiting for command discovery. v0.208.1 bills GPT and Grok models at 60% off for a limited time, with the discount shown in the model selector
- v0.206.0 (2026-08-28) made the CLI start up faster and applies project guidance when searching or listing files outside the current repository, and fixed reconnections on long-running sessions, hangs when archiving, renaming, or selecting sessions, and cancelling your first message. v0.205.0 (2026-08-26) starts a fresh session when you switch organizations, and v0.204.0 (2026-08-25) fixed repeated MCP reconnect prompts, state restoration on resumed sessions, and responses hanging after they finish. v0.207 is skipped in the changelog
- A full re-check of the official docs (cli-reference and settings) added /archive (archive the current session and restore it from the Archived tab in /sessions), listed in the slash command table (177 to 178 items). No CLI commands, flags, shortcuts, or settings were added, removed, or changed
CLI commands
droid
Start an interactive Droid TUI session in the current directory
Examples
droiddroid "query"
Start an interactive session with an initial prompt
Examples
droid "Explain the structure of this repo"droid --resume
Resume a previous session and open it in interactive mode
Key points
- Omitting the session ID resumes the most recently modified session
- The short form is -r; in droid exec, -r means --reasoning-effort instead
Examples
droid --resumedroid --resume session-abc123droid --fork <id>
Fork an existing session and resume the copy as a new session
Key points
- The original session stays intact, so you can try another approach from the same context
- Session IDs can be looked up with /sessions or droid search
Examples
droid --fork session-abc123droid exec "task"
Run a task non-interactively, ideal for CI, scripts, and automation
Key points
- --auto low|medium|high sets the autonomy level
- -o, --output-format selects text/json/stream-json
- -s, --session-id resumes an existing session
Examples
droid exec "Fix the failing tests"droid exec --auto medium "Update the README"droid exec -f prompt.md
Read the prompt from a file and run it non-interactively
Examples
droid exec -f prompt.mdcat file | droid exec
Pipe stdin into Droid for processing
Examples
git diff | droid exec "Draft release notes"droid exec --list-tools
List the tools available in exec mode and exit
droid exec -s <id> "query"
Resume an existing session in exec mode by passing its session ID
Key points
- -s, --session-id takes the ID of the session to resume
- Session IDs are printed by droid exec and can be looked up with droid search
Examples
droid exec -s abc123 "Continue with the remaining tests"droid search "query"
Full-text search across local sessions (alias: droid find)
Key points
- --kind filters entry types (message_text/document/tool_use/tool_result/all)
- --limit-sessions / --limit-hits cap the number of results
- --context-chars sets the surrounding characters shown per hit
- --json outputs JSON, --reindex rebuilds the search index
Examples
droid search "auth bug"droid mcp add
Add an MCP server
Key points
- --type sets the transport (http/sse/stdio)
- --env KEY=VALUE sets env vars for stdio servers (repeatable)
- --header adds HTTP headers for remote servers (repeatable)
Examples
droid mcp add linear https://mcp.linear.app/sse --type ssedroid mcp remove
Remove a registered MCP server
Examples
droid mcp remove lineardroid plugin install
Install a plugin (alias: droid plugin i)
Key points
- -s, --scope user|project sets the install scope
droid plugin uninstall
Uninstall a plugin (alias: droid plugin remove)
droid plugin update
Update a plugin to the latest version
droid plugin list
List installed plugins
droid plugin marketplace
Manage plugin marketplaces
droid computer register
Register your own machine for BYOM (Bring Your Own Machine)
Key points
- -y, --yes skips interactive prompts
droid computer remove
Remove a BYOM machine registration
droid computer list
List registered BYOM machines
droid computer ssh
SSH into a registered BYOM machine
droid computer port-forward
Forward a local port to a registered computer (BYOM machine) through the relay
Examples
droid computer port-forward 3000droid daemon
Run the Factory daemon server
droid update
Update the Droid CLI itself to the latest version
Key points
- -c, --check only checks whether an update is available (does not apply)
- -v, --version updates to the specified version
Examples
droid updateCLI flags
-f, --file
Read the prompt from a file
-m, --model
Select a specific model ID to use
Examples
droid -m gpt-5-codex-s, --session-id
Continue an existing session by its ID
--auto
Set the autonomy level: low for safe edits only, medium for development work, high for broad operations such as deployment
Key points
- low: auto-approve safe edits only
- medium: auto-approve typical development work
- high: auto-approve broad operations including deployment
Examples
droid exec --auto medium "Update dependencies"--restrict-tools
Restrict the agent to only the specified tools (replaces the old --enabled-tools)
--additional-tools
Force-enable tools that are disabled by default
--disable-builtin-skills
Disable the built-in skills provided by Factory (added in v0.176.0)
--disabled-tools
Disable specific tools
--list-tools
List available tools and exit
-o, --output-format
Set the output format (text/json/stream-json/stream-jsonrpc)
--input-format
Set the input format (use stream-jsonrpc for multi-turn)
-r, --resume
Resume a previous session; omit the session ID to resume the most recent one
Examples
droid --resume-r, --reasoning-effort
Set the reasoning effort level (off/none/low/medium/high). The -r short form is context-dependent: in droid exec it maps to this flag, while in interactive mode it maps to --resume
--spec-model
Use a different model ID for spec planning (Spec Mode)
--spec-reasoning-effort
Set the reasoning effort level for Spec Mode
--use-spec
Start in Spec Mode: plan the work as a spec before executing
--skip-permissions-unsafe
Skip all permission prompts (use with care — safety checks are bypassed)
--cwd
Run Droid from a specific working directory
-w, --worktree
Run the session inside a git worktree, isolating file changes so you can work on multiple branches in parallel
Examples
droid -w feature-login "Implement the login feature"--tag
Tag the session (repeatable)
--log-group-id
Set a log group ID for log filtering
--fork
Fork an existing session and resume it, keeping the original intact
--mission
Run the task in Mission Mode (multi-agent execution)
--worker-model
Set the model ID for mission worker agents
--worker-reasoning-effort
Set the reasoning effort for mission worker agents
--validator-model
Set the model ID for mission validator agents
--validator-reasoning-effort
Set the reasoning effort for mission validator agents
--append-system-prompt
Append text to the end of the system prompt
--append-system-prompt-file
Append the contents of a file to the end of the system prompt
-v, --version
Print the Droid CLI version
-h, --help
Show help information
Slash commands
/help
Show the list of available slash commands
/model
Switch the model mid-session
/settings
Open the application settings
/sessions
List previous sessions and pick one to resume
/new
Start a new session (same as /clear)
/clear
Start a new session (alias: /new)
/compress
Compress and summarize the session into a new one — useful when the context window fills up
/context
Show a breakdown of context window usage
/cost
Show usage statistics such as token consumption
/stats
Show usage statistics; supports relative periods and date ranges
/status
Show Droid status and current configuration
/review
Start an AI-driven code review workflow
/mcp
Manage MCP servers, with 40+ pre-configured options such as Linear, Sentry, and Notion
/skills
Manage and run skills (reusable procedures)
/create-skill
Create a reusable skill from the current session
/droids
Manage custom droids (purpose-built agents)
/missions
Enter Mission Mode (multi-agent execution)
/fast
Enable fast mode (disable with /fast off)
/btw
Ask a side question without polluting the main transcript
/copy
Copy prompts, responses, turn ranges, or the session ID
/fork
Duplicate all messages of the current session into a new one
/rename
Rename the current session
/favorite
Mark the current session as a favorite
/archive
Archive the current session; you can restore it from the Archived tab in /sessions
/rewind-conversation
Undo recent changes in the session
/tree
Browse the current session's fork tree and switch to and resume any branch
/cwd
Change the session's working directory
/cd
Change the session's working directory (alias for /cwd)
/commands
Manage custom slash commands
/hooks
Manage lifecycle hooks
/plugins
Manage plugins and marketplaces
/ide
Configure IDE integrations
/language
Switch the TUI display language
/themes
Choose a color theme
/statusline
Configure a custom status line
/terminal-setup
Configure the Shift+Enter key binding in your terminal
/diagnostics
Show configuration errors
/limits
Manage token usage limits and overage settings
/login
Sign in to Factory
/logout
Sign out of Factory
/account
Open your Factory account settings in the browser
/billing
View and manage billing settings
/share
Share the session with your organization
/install-code-review
Set up automated code review
/install-slack-app
Install and connect the Slack integration
/setup-incident-response
Set up Slack auto-run for incident response channels
/readiness-report
Generate an agent-readiness report
/readiness-fix
Fix readiness signals that failed in the latest report
/bug
File a bug report with session data and logs attached
/quit
Exit Droid (alias: exit; pressing Ctrl+C twice also quits)
Shortcuts
Ctrl+C
Cancel or interrupt the current operation (press twice to quit)
Shift+Tab
Cycle interaction modes (Auto → Spec → Mission)
Tab
Cycle reasoning effort (low → medium → high → off)
Ctrl+L
Cycle autonomy levels (while typing)
Ctrl+N
Cycle available models (while typing)
@
Open file path autocomplete with fuzzy search
!
Toggle bash mode when the input is empty, to run shell commands directly
Shift+Enter
Insert a newline in the chat input for multi-line editing
Up/Down
Navigate input history
Esc
Close the active overlay or menu
EscEsc
Press twice to clear the input draft, three times to open the rewind menu
Ctrl+O
Toggle the detailed transcript view
Ctrl+T
Toggle the mission control overlay
Ctrl+Y
Toggle the /btw scroll view
Ctrl+J
Toggle the changelog view
Alt+E
Toggle the approval details view (Option+E on macOS)
Ctrl+V
Paste an image from the clipboard as an attachment
?
Toggle the help popup (when the input is empty)
Ctrl+/
Toggle the help popup (works anytime)
Ctrl+A
Move the cursor to the start of the line
Ctrl+W
Delete the word before the cursor
Ctrl+K
Delete from the cursor to the end of the line
Ctrl+U
Delete from the cursor to the start of the line
Ctrl+D
Remove all attached images, or delete the next character
Ctrl+F
Open the fork tree for the highlighted session (in the /sessions list)
Ctrl+R
Rename the highlighted session (in the /sessions list)
Ctrl+X
Archive the highlighted session (in the /sessions list)
Alt+Up
Scroll the transcript up (any turn)
Alt+Down
Scroll the transcript down (any turn)
Alt+PageUp
Scroll the transcript up to the previous user turn
Alt+PageDown
Scroll the transcript down to the next user turn
Ctrl+Z
Suspend the process (Unix only; resume with fg)
Settings
~/.factory/settings.json
User settings file: ~/.factory/settings.json on macOS/Linux, %USERPROFILE%\.factory\settings.json on Windows
settings.local.json
Local override file placed in the same directory as settings.json
model
Set the default AI model
Examples
"model": "claude-sonnet-4-6"reasoningEffort
Set the default reasoning effort (off/low/medium/high)
sessionDefaultSettings.autonomyLevel
Set the default autonomy level for sessions
sessionDefaultSettings.interactionMode
Set the default interaction mode for sessions (auto or spec)
sessionDefaultSettings.specModeModel
Set the default model ID used in Spec Mode (spec planning)
sessionDefaultSettings.specModeReasoningEffort
Set the default reasoning effort used in Spec Mode (spec planning)
commandAllowlist
List of safe commands that run without confirmation
commandDenylist
List of commands that always require confirmation
commandBlocklist
List of commands that can never run, even with confirmation
theme
Set the color theme
diffMode
Set the diff display style (github or unified)
cloudSessionSync
Mirror sessions to the web (cloud) or keep them local
wikiCloudSync
Sync AutoWiki-generated wikis to the cloud (Cloud & Sync section in settings)
enableDroidShield
Enable or disable secret scanning
completionSound
Set the sound played when a response finishes (off/bell/fx-ok01/fx-ack01/custom file path)
awaitingInputSound
Set the sound played while Droid is waiting for input
soundFocusMode
Set when sound notifications play (always/focused/unfocused)
includeCoAuthoredByDroid
Automatically append the Droid co-author trailer to commits
hooksDisabled
Globally disable execution of all hooks
disabledSkills
Disable specific discovered skills so Droid won't invoke them, without deleting their files
ideAutoConnect
Auto-connect to your IDE when running from external terminals
showThinkingInMainView
Show the AI's thinking/reasoning blocks in the main chat view
customModels
Array of custom model configurations for BYOK (Bring Your Own Key)
toolResultDisplay
Set how tool results are rendered in the transcript (expanded/compact)
showTokenUsageIndicator
Show the live token usage indicator below the input
logoAnimation
Set how the Droid logo animates on startup (once/always/off)
overrideTerminalColors
Force Droid's theme colors to override the terminal's color scheme
nerdFont
Enable Nerd Font glyphs in the UI (requires a Nerd Font in your terminal)
statusLine
Configure a custom status line; the command's stdout is rendered above the input
worktreeDirectory
Set the default parent directory for git worktrees created with --worktree / -w
llmRequestTimeout
Set the timeout in milliseconds for individual LLM requests
specSaveDir
Set the directory where Spec Mode saves specs
subagentSounds
Play sounds for subagent lifecycle events (start, complete, error) — on/off
blockOnMcpLoad
Whether to wait for MCP servers to finish loading before starting an agent turn (boolean, defaults to false)
Key points
- Set to true so the agent only starts once every MCP server has finished loading, avoiding missed tools
- false (the default) starts without waiting, which is faster but may leave MCP tools unregistered on the first turn
Examples
"blockOnMcpLoad": truetodoDisplayMode
Control how the todo list is shown in the terminal UI (string, defaults to the product default)
completionSoundFocusMode
Override focus behavior for completion sounds (always/focused/unfocused, inherits soundFocusMode when unset)
awaitingInputSoundFocusMode
Override focus behavior for awaiting-input sounds (always/focused/unfocused, inherits soundFocusMode when unset)
showHookOutput
Set to true to show hook stdout and stderr in the session transcript for debugging
remoteAccessEnabled
Allow this machine to be used for remote Droid Computer access (boolean, defaults to false)
Version history
Droid CLI versions used to verify the data on this page, with their main changes.
v0.209.x (September 1, 2026)
- Verified against v0.209.0 (2026-09-01). You can now archive the current session from chat with /archive or Ctrl+X and restore it from the Archived tab in /sessions (both are already listed here). Sessions with no model selected now default to GPT-5.6 Sol, and the CLI starts on time when organization settings load slowly, applying them once they arrive
- Bug fixes: text selected in a diff no longer clears when the session sidebar updates, and the environment panel stays visible while repository details load or refresh. Opening a file link now centers the target line (all app-side), and running out of credits suggests an available Droid Core model instead of a retired one
- A full re-check of the official docs (cli-reference and settings) found no CLI commands, flags, slash commands, shortcuts, or settings added, removed, or changed (still 178 items listed)
v0.208.x (August 29, 2026)
- Verified against v0.208.1 (2026-08-29). In v0.208.0, organization owners can require people on verified email domains to join by invitation instead of creating a new organization. Screenshots, diagrams, and tables keep fine detail when Droid resizes images, /new and /clear show progress while the next session is created, You.com joined the MCP server registry, and built-in slash commands run immediately instead of waiting for command discovery. v0.208.1 bills GPT and Grok models at 60% off for a limited time, with the discount shown in the model selector
- v0.206.0 (2026-08-28) made the CLI start up faster and applies project guidance when searching or listing files outside the current repository, and fixed reconnections on long-running sessions, hangs when archiving, renaming, or selecting sessions, and cancelling your first message. v0.205.0 (2026-08-26) starts a fresh session when you switch organizations, and v0.204.0 (2026-08-25) fixed repeated MCP reconnect prompts, state restoration on resumed sessions, and responses hanging after they finish. v0.207 is skipped in the changelog
- A full re-check of the official docs (cli-reference and settings) added /archive (archive the current session and restore it from the Archived tab in /sessions), listed in the slash command table (177 to 178 items). No CLI commands, flags, shortcuts, or settings were added, removed, or changed
v0.203.x (August 25, 2026)
- Verified against v0.203.0 (2026-08-25). A queued or pending steering message can now be moved back into the composer to change its text or attachments before it is sent, and turning on or shortening session retention warns you that sessions past the limit are permanently deleted before you save. A skill command can now start after other text in a request, and text beginning with an unmatched slash submits normally instead of being blocked
- v0.202.0 (2026-08-21) made the CLI start up faster and let org admins turn off image generation for the whole organization. Lifecycle hooks run again instead of being skipped, a damaged local plugin cache repairs itself, and Simplified Chinese text in the interface is translated correctly. v0.200.0 (2026-08-20) asks before changing your working tree after a failed Git pull, loads file search tooling only when it is needed so sessions start sooner, reports real process IDs for background commands, and keeps MCP server connections authenticated across reconnects. v0.201 is skipped in the changelog
- A full re-check of the official docs (cli-reference and settings) added droid --resume (resume a previous session) and droid --fork (fork a session and resume the copy), both listed as their own rows in the CLI commands table (175 to 177 items). No CLI flags, slash commands, shortcuts, or settings were added, removed, or changed
v0.199.x (August 18, 2026)
- Verified against v0.199.0 (2026-08-18). The TypeScript SDK can now set a custom system prompt for a session, and the built-in Explorer droid can use all read-only tools. Question prompts gained keyboard controls (Space/number keys to select, Tab to move between questions), diagrams render with the official Mermaid engine, and rendering is faster for long sessions and streaming output
- v0.198.0 (2026-08-17) added automatic line wrapping for long diff lines and a clearer explanation when a model returns an empty response, and fixed diff search scrolling, model selector focus retention, empty draft sessions piling up, and mission handling after machine sleep
- A full re-check of the official docs (cli-reference and settings) found no additions, removals, or changes to CLI commands, flags, slash commands, shortcuts, or settings (175 items unchanged)
v0.197.x (August 15, 2026)
- Verified against v0.197.0 (2026-08-15). Moving between choices in question and permission prompts no longer jumps to whichever item the mouse cursor happens to sit on
- In v0.196.0, forking a session now keeps you in the original session and shows a resume command for opening the copy. Context added by a SessionStart hook is kept for the rest of the session instead of being discarded, and credit usage for Grok 4.5 and GPT-5.3-Codex fast mode is now counted at the correct rate
- A full re-check of the official docs (cli-reference and settings) added droid exec -s, which resumes an existing session in exec mode (174 to 175 items). No CLI flags, slash commands, shortcuts, or settings were added, removed, or changed
v0.195.x (August 13, 2026)
- Verified against v0.195.0 (2026-08-13). Escape now asks for confirmation before interrupting a run, sidebar stability improved, and fixes landed for text selection breaking after a panel resize, recent sessions missing from the sidebar, repeated polling tool calls, and plugin file watcher management
- v0.194.0 (2026-08-12) let sessions fetch their own messages directly through the TypeScript SDK and added a spec mode helper for SDK users (both SDK-side features, outside this CLI reference). It also fixed garbled pinned mission proposals, delayed custom model credential errors, line breaks lost when copying text, and the idle todo spinner
- A full re-check of the official docs (cli-reference and settings) added the slash command /cd, an alias for /cwd (173 to 174 items). No CLI commands, flags, shortcuts, or settings were added, removed, or changed
v0.193.x (August 11, 2026)
- Verified against v0.193.0 (2026-08-11). Session history search is faster, and fixes landed for turns stalling on repeated identical tool calls, lowercase proxy variables (https_proxy and friends) being ignored, the credit usage chart counting daily totals on the wrong day, and diffs that failed to load retrying forever
- MiniMax M2.5 was deprecated and dropped from the model options. v0.191 and v0.192 are skipped in the changelog; v0.193.0 is the release right after v0.190.0
- A full re-check of the official docs (cli-reference and settings) found no added, removed, or changed CLI commands, flags, slash commands, shortcuts, or settings (still 173 items)
v0.190.x (August 2026)
- Verified against v0.190.0 (2026-08-07). Droid now uses your HTTPS_PROXY setting so sessions work behind a corporate proxy, the Auto model upgrades to Claude Opus 5 when a task needs it, and the install-qa skill can set up automated QA on GitLab CI
- v0.187.0 through v0.189.0 were mostly bug fixes: a failing custom status line now names the problem and points to /statusline, custom models that get their key from a helper command start up, turns that end with an empty response finish successfully, PDF attachments fall back to extracted text, and skills with broken symlinks are skipped instead of blocking the rest
- No upstream additions, removals, or changes to CLI commands, flags, slash commands, shortcuts, or settings. Separately, the mcp.callTimeoutMs setting was dropped from this page because it no longer appears in the official docs (174 to 173 items)
v0.186.x (July 2026)
- Verified against v0.186.0 (2026-07-31). Improved recognition of self-hosted Git remotes (GitHub Enterprise/GitLab) and fixed transcript slowdowns during long streaming responses; links in tmux are now clickable
- Fixed the command denylist wrongly blocking related commands, and a table scrollbar overlapping content
- A full re-check of the official docs found /tree (browse the fork tree), Ctrl+F (open the fork tree from the /sessions list), and disabledSkills (disable specific skills) added since the docs were last fully audited. The approval-details-view shortcut changed from Ctrl+E to Alt+E (Option+E on macOS) (171 → 174 items)
v0.185.x (July 2026)
- Verified against v0.185.0 (2026-07-30). You can now set a connection timeout per MCP server
- Fixed approval prompts becoming unresponsive, Spec mode message colors being lost on re-render and session resume, and sign-in and MCP authorization completing in a different window from the one that started it
- No new, removed, or changed CLI commands, flags, slash commands, shortcuts, or settings (still 171 items; v0.184.x is skipped in the changelog)
v0.183.x (July 2026)
- Verified against v0.183.0 (2026-07-29). Agents can now ask multi-select questions, and file previews can be toggled to full screen
- Improved how MCP tool details are shown in the transcript, and added attachment previews when queueing a message
- Added the todoDisplayMode, completionSoundFocusMode, awaitingInputSoundFocusMode, showHookOutput, and remoteAccessEnabled settings, bringing the list to 171 items. No changes to CLI commands, flags, slash commands, or shortcuts
v0.182.x (July 2026)
- Verified against v0.182.0 (2026-07-28). Added a scope filter to audit logs and the ability to delete users from the admin console
- You can now copy images with a right click, and artifact previews show thumbnails
- Consolidated the several cron tools into a single loop tool
v0.181.x (July 2026)
- Verified against v0.181.0 (2026-07-27). Slash commands can now be used while an agent is running
- Added a resource override (the resource field) to MCP OAuth configuration
- Bug fixes: retry when the Git index is locked, and corrected computer scoping for BYOK models
v0.180.x (July 2026)
- Verified against v0.180.0 (2026-07-24). Added Gemini 3.6 Flash to the model selector, and you can now turn off Factory-provided built-in skills from the app
- Redesigned the keyboard shortcuts help dialog to be easier to scan, and tuned agent turns to wait for MCP servers to finish loading. Session search now runs server-side and supports looking up a session by its ID, and MCP server authentication is unified with the CLI flow
- Bug fixes: spec proposals now keep chronological order in the transcript, and cards no longer show a broken image when the desktop app fails to load one. No changes to CLI commands, flags, slash commands, shortcuts, or settings (still 166 items)
v0.179.x (July 2026)
- Verified against v0.179.0 (2026-07-23). Strengthened isolation of processes running inside the command sandbox and hardened macOS releases against code injection
- Fixed the mission proposal body repeating during approval, added graceful back-off when a model is temporarily at capacity, and fixed long voice dictations being cut off, streamed visualization flicker, the composer autonomy chip width, and GitHub Enterprise Server repository scoping
- Added the blockOnMcpLoad setting (wait for MCP servers to finish loading before starting an agent turn), bringing the list to 166 items. No changes to CLI commands, flags, slash commands, or shortcuts
v0.178.x (July 2026)
- v0.178.0 (2026-07-22) added a new setting that keeps your machine awake during agent runs, so long tasks are no longer interrupted by sleep
- The CLI and desktop now trust your system's certificates at startup, improving connectivity in environments with custom certificate authorities
- Fixed autonomy upgrades not applying to MCP tool confirmations, improved the reliability of MCP OAuth sign-in, kept hook metadata on a single row, and made invitations respect your organization's verified domains
v0.177.x (July 2026)
- Verified against v0.177.0 (2026-07-21). Added the ability to open artifacts in an external editor, switched code blocks to Geist Mono, and added support for sending attachment-only messages
- Fixed several bugs around the approval-details toggle, transcript re-rendering, and session handling
- No new, removed, or changed CLI commands, flags, slash commands, shortcuts, or settings (165 items listed, unchanged — verification update only)
v0.176.x (July 2026)
- Verified against v0.176.0 (2026-07-20). Added the --disable-builtin-skills flag (disables Factory's built-in skills) and native Windows ARM64 builds
- --enabled-tools was removed from the official reference and replaced by --restrict-tools (limit to the specified tools) and --additional-tools (force-enable tools off by default). Newly added droid computer port-forward, the wikiCloudSync setting, and Spec Mode sessionDefaultSettings keys (165 items listed)
- Added admin usage-limit alert emails, a fix for session history corruption on tool cancellation, and automatic retries when a model is unavailable
v0.175.x (July 2026)
- Verified against v0.175.0 (2026-07-17). Added automatic previews for generated files and task-ID prefixes for TaskOutput/TaskStop
- Fixed /btw mid-stream handling, model-setting persistence, and wiki share links
- No new, removed, or changed CLI commands, flags, slash commands, shortcuts, or settings (v0.174.x is skipped in the changelog)
v0.173.x (July 2026)
- Verified against v0.173.0 (2026-07-15). v0.172.0 added a mission side panel and v0.173.0 added per-skill disabling with cross-scope settings resolution — mostly app/UI improvements and bug fixes (/clear now preserves the model, MCP sign-in silently refreshes tokens)
- No new, removed, or changed CLI commands, flags, slash commands, shortcuts, or settings (159 items listed, unchanged)
- Found the /wiki slash command and wikiCloudSync setting on the AutoWiki feature docs, but they're still not listed on the aggregator reference pages (cli-reference / settings), so they remain excluded from this page for now
v0.171.x (July 2026)
- Verified against v0.171.0 (2026-07-13). Context usage now displays immediately on session resume, and the Windows installer detects native architecture. Bug fixes for MCP connection timeouts and theme detection over SSH
- Added
subagentSounds, a new setting under "Additional sound and notification settings" for subagent lifecycle event sounds (159 items listed) - The droid computer port-forward command is still not documented on the official CLI reference, so it remains excluded from this page
v0.167.x (July 2026)
- Verified against v0.167.0 (2026-07-07). Faster startup via parallel boot phases, full-screen help (dismiss with
?/Esc), and clearer category grouping in the slash menu - The changelog announced a new droid computer port-forward command, but it isn't documented on the official CLI reference yet, so it isn't included on this page yet (pending a docs update)
- Re-verification found droid mcp list is no longer documented anywhere in the official docs, so it was removed (158 items listed). The mcp CLI subcommands are now just add/remove
v0.164.x (July 2026)
- Verified against v0.164.0 (2026-07-02). No new commands, flags, slash commands, or shortcuts were added, so the 159 listed items are unchanged
- Added a setting to control cloud sync (covered by
cloudSessionSync, already listed here), and a UI improvement that groups slash commands by category - Bug fixes: MCP tool names may contain dots,
droid execbackground processes persist after exit, and$EDITORis honored for allow/deny list editing on headless systems
v0.162.x (June 2026)
- Latest stable release, verified with v0.162.0. Significantly expanded the settings.json reference with new sound, display, mission, and infrastructure keys
- Removed the blog feature (the /generate_blog command and the Ctrl+P blog viewer toggle) from this page, since Factory removed it from Droid
- Added a hooks manager overhaul, in-transcript chat search, and clearer MCP authentication error messages (v0.151.0–v0.161.0)
v0.150.x (June 2026)
- Stable release, verified with v0.150.0. Every command, flag, and shortcut on this page was checked against the official docs for this version
- Added droid mcp list to show MCP connection and authentication status (v0.148.0), and the commandBlocklist setting to permanently block specified commands (v0.147.0)
- Added the Ctrl+Enter shortcut to queue messages (v0.146.0), plus npm plugin sources and a desktop quit confirmation
v0.144.x (June 2026)
- Stable release, verified with v0.144.1. Every command, flag, and shortcut on this page is checked against the official docs for this version
- Added related-file suggestions at session start
- Hardened handling of destructive worktree commands and improved MCP reliability
v0.143.x (June 2026)
- Maintenance release focused on routine upkeep and internal stability improvements
About this Factory Droid CLI cheat sheet
Droid by Factory is an AI coding agent that runs in your terminal. It stands out for fine-grained autonomy levels, plan-first execution with Spec Mode, and multi-agent runs with Mission Mode. This page is a cheat sheet of 178 items — CLI commands, flags, slash commands, keyboard shortcuts, and settings — verified against the official documentation for v0.209.0.
Features
- 178 items across 5 categories: CLI commands, flags, slash commands, shortcuts, and settings
- Full-text search across command names, descriptions, and examples
- Category filters to switch between terminal commands and in-TUI operations
- One-click copy so you can paste commands straight into your terminal
- Verified version and update history shown on the page (v0.209.0 / September 2026)
Use cases
- Look up droid exec options for CI and scripted automation
- Check the differences between --auto low, medium, and high
- Find slash commands and shortcuts while inside a TUI session
- Reference the main settings.json keys with examples
FAQ
What is the Droid CLI?
Droid is a terminal AI coding agent by Factory. Besides the interactive TUI, it supports non-interactive runs with droid exec for CI and automation, parallel work via git worktrees, and MCP server integrations.
What is the difference between --auto low, medium, and high?
Autonomy levels control what Droid may do without asking. The default is read-focused; low auto-approves safe edits only, medium covers typical development work, and high extends to broad operations such as deployment. Higher levels mean fewer prompts but more risk, so pick per task.
What are Spec Mode and Mission Mode?
Spec Mode (--use-spec) plans the work as a spec before executing. Mission Mode (--mission or /missions) is multi-agent execution where worker and validator agents split the task. Press Shift+Tab to cycle modes.
How do I install the Droid CLI?
Install it with the official script from factory.ai and keep it current with droid update. On first launch, sign in to your Factory account with /login.
Which version does this cheat sheet cover?
Droid CLI v0.209.x, tested with v0.209.0 in September 2026. Every command listed here is checked against the official docs at docs.factory.ai.
How does Droid differ from Claude Code or Codex CLI?
All three are terminal AI coding agents. Droid emphasizes fine-grained autonomy control and enterprise features such as session sharing, Slack integration, and automated code review, and lets you switch between models from multiple providers.
Where are settings stored?
In ~/.factory/settings.json on macOS/Linux and %USERPROFILE%\.factory\settings.json on Windows. A settings.local.json in the same directory provides local overrides.
Can keyboard shortcuts be customized?
This page lists the default key bindings. Newlines via Shift+Enter may require terminal-side configuration through /terminal-setup.