--- name: factory-ai description: Use Factory AI's droid CLI for software engineering tasks. Supports interactive mode, exec mode, MCP servers, and plugins. metadata: {"clawdbot":{"emoji":"🤖","requires":{"bins":["droid"]}} ---

Factory AI Droid CLI

Use droid to build features, debug, refactor, and deploy code.

Installation

Already installed at: /Users/mitchellbernstein/.local/bin/droid

Authentication

droid login
# or set FACTORY_API_KEY env var
export FACTORY_API_KEY=your-api-key

Commands

Interactive Mode

droid                           # Start fresh session
droid "fix the login bug"       # Start with prompt
droid -r                        # Resume last session
droid -r session-id             # Resume specific session

Non-Interactive (Exec Mode)

droid exec "analyze this file"
droid exec "commit my changes with a good message"
droid exec "deploy to fly.io"
droid exec --help               # Show exec options

Options for Exec

droid exec --force "fix lint errors"    # Auto-apply without confirmation
droid exec --json "analyze code"        # JSON output
droid exec --model claude "task"        # Specify model

MCP Servers

droid mcp list                    # List installed MCP servers
droid mcp add server-name         # Add MCP server
droid mcp remove server-name      # Remove MCP server

Plugins

droid plugin list                 # List plugins
droid plugin add name             # Add plugin

Usage Patterns

Feature Development

droid exec "add a user settings page with dark mode toggle"

Debugging

droid exec "fix this error: [paste error]"

Code Review

droid exec "review the PR for security issues"

Git Operations

droid exec "create a PR for my changes"
droid exec "write a good commit message for the staged changes"

Deployment

droid exec "deploy to fly.io"

Multi-file Changes

droid
# Then in interactive mode:
@src/components/
@src/api/
Implement authentication flow

Notes

• Droid has deep codebase understanding across your org
• Supports model flexibility (OpenAI, Anthropic, xAI, etc.)
• MCP servers for extended capabilities
• Session-based memory for context continuity