Droid

Factory AI's enterprise-grade AI coding agent with terminal integration and sophisticated workflow automation.

Overview

Factory Droid is a top-performing AI coding agent built by Factory AI that provides end-to-end development workflows, debugging, refactoring, and CI/CD integration. Droid scores 58.75% on terminal benchmarks and supports both interactive chat and headless automation modes.

Installation

NPM (Recommended)

npm install -g @factory/cli

Homebrew (macOS)

brew install factory/tap/droid

curl (Universal)

curl -fsSL https://get.factory.ai/droid | bash

Authentication

Factory AI Account Setup

1. Sign up at factory.ai/signup 2. Install Droid CLI (see Installation above) 3. Authenticate with Factory AI: ``bash droid auth login ` 4. Verify authentication: `bash droid whoami ``

Environment Variables

export DROID_API_KEY=your_factory_api_key

Usage with adapters

Basic Chat

adapters run droid --prompt "Help me refactor this API endpoint"

Resume Session

adapters run droid --session-id abc123 --prompt "Continue with the optimization"

Model Selection

adapters run droid --model gpt-5-turbo --prompt "Generate a complete REST API"
adapters run droid --model claude-sonnet --prompt "Review this code for security issues"
adapters run droid --model gemini-flash --prompt "Create unit tests for this module"

Auto-approve Tools (Yolo Mode)

adapters run droid --tool-approval-mode yolo --prompt "Fix all linting errors in src/"

Working Directory

adapters run droid --cwd /path/to/project --prompt "Analyze the codebase structure"

Supported Models

Default model: gpt-5-turbo

Capabilities

• **Multi-turn conversations** with session persistence
• **Tool calling** with parallel execution (up to 10 concurrent)
• **File operations** with comprehensive project analysis
• **Code generation** and refactoring with enterprise patterns
• **Debugging** and error analysis
• **CI/CD integration** via headless mode
• **MCP plugin support** for extensibility
• **Workflow automation** for complex development tasks
• **Interactive approval** or auto-approve (yolo) modes

Sessions

Droid sessions are stored in:

~/.config/droid/sessions/

Session Management

# List sessions
adapters sessions droid

# Read session
adapters sessions droid read <session-id>

# Resume session
adapters run droid --session-id <session-id>

# Fork session
adapters sessions droid fork <session-id> --name "feature-branch"

MCP Plugins

Droid supports MCP (Model Context Protocol) servers for enhanced functionality:

# List available plugins
adapters plugins list droid

# Install MCP server
adapters plugins install droid <mcp-server>

# List installed plugins
adapters plugins list droid --installed

Configuration

Droid configuration is stored in:

~/.config/droid/config.json

Project-specific Configuration

Create .droid/config.json in your project root:

{
  "defaultModel": "claude-sonnet",
  "autoApprove": false,
  "maxParallelTasks": 5,
  "workflowPresets": {
    "code-review": {
      "systemPrompt": "Focus on security, performance, and maintainability",
      "model": "gpt-5-turbo"
    }
  }
}

Enterprise Features

Headless Mode

Perfect for CI/CD pipelines and automation:

# One-shot execution
droid exec --prompt "Run all tests and fix failures" --headless

# Via adapters
adapters run droid --prompt "Generate deployment scripts" --headless

Parallel Execution

Droid can handle multiple tasks simultaneously:

adapters run droid --prompt "Optimize performance while fixing security issues"

Workflow Automation

Create complex development workflows:

adapters run droid --prompt "
1. Analyze the codebase for technical debt
2. Create refactoring plan
3. Implement high-priority improvements
4. Generate comprehensive tests
5. Update documentation
"

Error Handling

Common error codes and solutions:

Troubleshooting

Authentication Issues

# Check authentication status
droid whoami

# Re-authenticate
droid auth logout
droid auth login

Performance Issues

# Check system status
droid status

# Clear cache
droid cache clear

Session Issues

# Verify session directory
ls ~/.config/droid/sessions/

# Check session file integrity
adapters sessions droid read <session-id> --validate

Best Practices

1. **Use specific models** for different tasks: - gpt-5-turbo: General coding and architecture - claude-sonnet: Code review and documentation - gemini-flash: Quick prototyping and testing

2. **Leverage headless mode** for automation: ``bash adapters run droid --prompt "Daily code quality check" --headless ``

3. **Configure project-specific settings** in .droid/config.json

4. **Use auto-approve carefully** - only in trusted environments: ``bash adapters run droid --tool-approval-mode yolo --prompt "Format all files" ``

5. **Monitor costs** with cost tracking: ``bash adapters run droid --prompt "Complex refactoring task" | adapters cost ``

Links

• Factory AI Website
• Droid Documentation
• Factory AI Blog
• Terminal Benchmark Results