Factory AI Droid CLI

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

Installation

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

Authentication

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

Commands

Interactive Mode

bash
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)

bash
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

bash
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

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

Plugins

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

Usage Patterns

Feature Development

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

Debugging

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

Code Review

bash
droid exec "review the PR for security issues"

Git Operations

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

Deployment

bash
droid exec "deploy to fly.io"

Multi-file Changes

bash
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