{
  "id": "page:docs-agent-mux-reference-agents-droid",
  "_kind": "Page",
  "_file": "wiki/docs/agent-mux/reference/agents/droid.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/agent-mux/reference/agents/droid.md",
    "sourceKind": "repo-docs",
    "title": "Droid",
    "displayName": "Droid",
    "slug": "docs/agent-mux/reference/agents/droid",
    "articlePath": "wiki/docs/agent-mux/reference/agents/droid.md",
    "article": "\n# Droid\n\nFactory AI's enterprise-grade AI coding agent with terminal integration and sophisticated workflow automation.\n\n## Overview\n\n[Factory Droid](https://factory.ai) 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.\n\n## Installation\n\n### NPM (Recommended)\n```bash\nnpm install -g @factory/droid-cli\n```\n\n### Homebrew (macOS)\n```bash\nbrew install factory/tap/droid\n```\n\n### curl (Universal)\n```bash\ncurl -fsSL https://get.factory.ai/droid | bash\n```\n\n## Authentication\n\n### Factory AI Account Setup\n1. Sign up at [factory.ai/signup](https://factory.ai/signup)\n2. Install Droid CLI (see Installation above)\n3. Authenticate with Factory AI:\n   ```bash\n   droid auth login\n   ```\n4. Verify authentication:\n   ```bash\n   droid whoami\n   ```\n\n### Environment Variables\n```bash\nexport DROID_API_KEY=your_factory_api_key\n```\n\n## Usage with agent-mux\n\n### Basic Chat\n```bash\namux run droid --prompt \"Help me refactor this API endpoint\"\n```\n\n### Resume Session\n```bash\namux run droid --session-id abc123 --prompt \"Continue with the optimization\"\n```\n\n### Model Selection\n```bash\namux run droid --model gpt-5-turbo --prompt \"Generate a complete REST API\"\namux run droid --model claude-sonnet --prompt \"Review this code for security issues\"\namux run droid --model gemini-flash --prompt \"Create unit tests for this module\"\n```\n\n### Auto-approve Tools (Yolo Mode)\n```bash\namux run droid --tool-approval-mode yolo --prompt \"Fix all linting errors in src/\"\n```\n\n### Working Directory\n```bash\namux run droid --cwd /path/to/project --prompt \"Analyze the codebase structure\"\n```\n\n## Supported Models\n\n| Model ID | Alias | Context Window | Output Tokens | Input Price | Output Price |\n|----------|-------|----------------|---------------|-------------|--------------|\n| `gpt-5-turbo` | `gpt-5-turbo` | 256,000 | 16,384 | $2.00/1M | $8.00/1M |\n| `claude-3-5-sonnet-20241022` | `claude-sonnet` | 200,000 | 8,192 | $3.00/1M | $15.00/1M |\n| `gemini-2-flash` | `gemini-flash` | 1,000,000 | 8,192 | $0.075/1M | $0.30/1M |\n\nDefault model: `gpt-5-turbo`\n\n## Capabilities\n\n- **Multi-turn conversations** with session persistence\n- **Tool calling** with parallel execution (up to 10 concurrent)\n- **File operations** with comprehensive project analysis\n- **Code generation** and refactoring with enterprise patterns\n- **Debugging** and error analysis\n- **CI/CD integration** via headless mode\n- **MCP plugin support** for extensibility\n- **Workflow automation** for complex development tasks\n- **Interactive approval** or auto-approve (yolo) modes\n\n## Sessions\n\nDroid sessions are stored in:\n```\n~/.config/droid/sessions/\n```\n\n### Session Management\n```bash\n# List sessions\namux sessions droid\n\n# Read session\namux sessions droid read <session-id>\n\n# Resume session\namux run droid --session-id <session-id>\n\n# Fork session\namux sessions droid fork <session-id> --name \"feature-branch\"\n```\n\n## MCP Plugins\n\nDroid supports MCP (Model Context Protocol) servers for enhanced functionality:\n\n```bash\n# List available plugins\namux plugins list droid\n\n# Install MCP server\namux plugins install droid <mcp-server>\n\n# List installed plugins\namux plugins list droid --installed\n```\n\n## Configuration\n\nDroid configuration is stored in:\n```\n~/.config/droid/config.json\n```\n\n### Project-specific Configuration\nCreate `.droid/config.json` in your project root:\n```json\n{\n  \"defaultModel\": \"claude-sonnet\",\n  \"autoApprove\": false,\n  \"maxParallelTasks\": 5,\n  \"workflowPresets\": {\n    \"code-review\": {\n      \"systemPrompt\": \"Focus on security, performance, and maintainability\",\n      \"model\": \"gpt-5-turbo\"\n    }\n  }\n}\n```\n\n## Enterprise Features\n\n### Headless Mode\nPerfect for CI/CD pipelines and automation:\n```bash\n# One-shot execution\ndroid exec --prompt \"Run all tests and fix failures\" --headless\n\n# Via agent-mux\namux run droid --prompt \"Generate deployment scripts\" --headless\n```\n\n### Parallel Execution\nDroid can handle multiple tasks simultaneously:\n```bash\namux run droid --prompt \"Optimize performance while fixing security issues\"\n```\n\n### Workflow Automation\nCreate complex development workflows:\n```bash\namux run droid --prompt \"\n1. Analyze the codebase for technical debt\n2. Create refactoring plan\n3. Implement high-priority improvements\n4. Generate comprehensive tests\n5. Update documentation\n\"\n```\n\n## Error Handling\n\nCommon error codes and solutions:\n\n| Error Code | Description | Solution |\n|------------|-------------|----------|\n| `AUTH_FAILED` | Authentication required | Run `droid auth login` |\n| `API_QUOTA_EXCEEDED` | Usage limits reached | Check billing at factory.ai |\n| `INVALID_MODEL` | Model not available | Use supported model ID |\n| `TOOL_EXECUTION_FAILED` | Tool call failed | Check file permissions and paths |\n\n## Troubleshooting\n\n### Authentication Issues\n```bash\n# Check authentication status\ndroid whoami\n\n# Re-authenticate\ndroid auth logout\ndroid auth login\n```\n\n### Performance Issues\n```bash\n# Check system status\ndroid status\n\n# Clear cache\ndroid cache clear\n```\n\n### Session Issues\n```bash\n# Verify session directory\nls ~/.config/droid/sessions/\n\n# Check session file integrity\namux sessions droid read <session-id> --validate\n```\n\n## Best Practices\n\n1. **Use specific models** for different tasks:\n   - `gpt-5-turbo`: General coding and architecture\n   - `claude-sonnet`: Code review and documentation\n   - `gemini-flash`: Quick prototyping and testing\n\n2. **Leverage headless mode** for automation:\n   ```bash\n   amux run droid --prompt \"Daily code quality check\" --headless\n   ```\n\n3. **Configure project-specific settings** in `.droid/config.json`\n\n4. **Use auto-approve carefully** - only in trusted environments:\n   ```bash\n   amux run droid --tool-approval-mode yolo --prompt \"Format all files\"\n   ```\n\n5. **Monitor costs** with cost tracking:\n   ```bash\n   amux run droid --prompt \"Complex refactoring task\" | amux cost\n   ```\n\n## Links\n\n- [Factory AI Website](https://factory.ai)\n- [Droid Documentation](https://docs.factory.ai/droid)\n- [Factory AI Blog](https://factory.ai/blog)\n- [Terminal Benchmark Results](https://factory.ai/news/terminal-bench)\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-agent-mux-reference",
      "to": "page:docs-agent-mux-reference-agents-droid",
      "kind": "contains_page"
    }
  ]
}