Factory Droid

Factory is an AI-native software development platform that works everywhere you do. From IDE to CI/CD – delegate complete tasks like refactors, incident response, and migrations to Droids without changing your tools, models, or workflow.

Quick Start

# Navigate to your project directory
cd your-project

# Start the droid CLI
droid

# Explore your codebase
> analyze this codebase and explain the overall architecture

# Make your first change
> add comprehensive logging to the main application startup

Installation

Download and install from factory.ai, then run droid in your terminal.

Key Features

• Model-agnostic: OpenAI, Anthropic, Google, X AI, open-source or local models
• Context-confidence: Compresses incrementally with anchor points for near-perfect context
• Specification mode: Detailed implementation, technical details and mixed model support
• Enterprise-ready: SSO + SAML, dedicated compute, compliance & security

Documentation

Full documentation in docs/. See docs/000-index.md for detailed navigation.

By Topic

By Keyword

Learning Path

Level 1: Foundation

• Files 001-010: Introduction to Factory platform
• Files 011-019: Quickstart and common use cases

Level 2: Core Understanding

• Files 026-029: Security, skills, IAM concepts
• Files 041-050: Settings, AGENTS.md, custom droids, hooks

Level 3: Practical Application

• Files 051-060: BYOK custom models configuration
• Files 061-068: Domain-specific skills
• Files 101-116: Automation tutorials

Level 4: Advanced Usage

• Files 071-080: User features and workflows
• Files 091-095: Power user optimization
• Files 121-128: Enterprise deployment

Level 5: Reference

• Files 136-143: API and CLI reference
• Files 156-159: Changelog and version history

Common Tasks

Configure AI Model

-> docs/041-cli-configuration-settings.md (model selection, reasoning effort) -> docs/051-cli-byok-overview.md (custom models setup)

Set Up AGENTS.md

-> docs/042-cli-configuration-agents-md.md (specification, templates, best practices)

Create Custom Slash Commands

-> docs/044-cli-configuration-custom-slash-commands.md (Markdown templates, executable scripts)

Configure Hooks

-> docs/045-cli-configuration-hooks-guide.md (lifecycle events, shell commands) -> docs/137-reference-hooks-reference.md (full reference)

Use Specification Mode

-> docs/073-cli-user-guides-specification-mode.md (planning, workflow, autonomy)

Set Up Code Review

-> docs/076-cli-features-code-review.md (/review command, workflows) -> docs/103-guides-droid-exec-code-review.md (automated PR reviews)

Configure GitHub Integration

-> docs/016-integrations-github-app.md (GitHub App setup) -> docs/104-guides-droid-exec-github-actions.md (CI/CD workflows)

Run Headless/CI Mode

-> docs/080-cli-droid-exec-overview.md (droid exec, automation) -> docs/101-guides-building-droid-exec-tutorial.md (tutorial)

Optimize Token Usage

-> docs/095-guides-power-user-token-efficiency.md (strategies, model selection)

Enterprise Deployment

-> docs/121-enterprise.md (overview, security, governance) -> docs/122-enterprise-network-and-deployment.md (network, airgap, proxies)

Settings Reference

Settings file location:

• macOS/Linux: ~/.factory/settings.json
• Windows: %USERPROFILE%\.factory\settings.json

Key settings:

{
  "model": "opus",
  "reasoningEffort": "low",
  "autonomyLevel": "normal",
  "diffMode": "github",
  "cloudSessionSync": true,
  "enableDroidShield": true
}

Available models: opus, sonnet, haiku, gpt-5.1, gpt-5.1-codex, gpt-5.2, gemini-3-pro, droid-core, custom-model

Slash Commands