Factory Droid

​

Step 1: Installing Factory Droid

  curl -fsSL https://app.factory.ai/cli | sh

  irm https://app.factory.ai/cli/windows | iex

​

Step 2: Configuring Z.AI GLM Models

​

1. Get Your Z.AI API Key

• Visit the Z.AI API Console
• Create an API key if you don’t have one

​

2. Configure Custom Models

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

{
  "customModels": [
    {
      "displayName": "GLM [Z.AI Coding Plan] - Anthropic",
      "model": "glm-5.2",
      "baseUrl": "https://api.z.ai/api/anthropic",
      "apiKey": "your_api_key",
      "provider": "anthropic",
      "maxOutputTokens": 131072
    }
  ]
}

{
  "customModels": [
    {
      "displayName": "GLM [Z.AI Coding Plan] - Openai",
      "model": "glm-5.2",
      "baseUrl": "https://api.z.ai/api/coding/paas/v4",
      "apiKey": "your_api_key",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 131072
    }
  ]
}

• GLM Coding Plan users must use the Coding API endpoint: https://api.z.ai/api/coding/paas/v4
• Standard plan users use the general API endpoint: https://api.z.ai/api/paas/v4
• Replace your_api_key with your actual API key
• API keys are stored locally and never uploaded to Factory servers

​

Step 3: Start Using Factory Droid

​

1. Launch Droid

cd /path/to/your/project
droid

​

2. Select Your Z.AI Model

/model

​

3. Start Coding

​

Key Features

• Press Shift+Tab to activate
• Describe features in plain language
• Get automatic planning before implementation
• Approve plans before any code changes

• Low: Edits and read-only commands
• Medium: Reversible commands (package installs, builds, local git, etc.)
• High: All commands except explicitly dangerous ones
• Cycle modes with Shift+Tab

• VS Code/Cursor/Windsurf: Auto-installs when you run droid
• JetBrains: Install plugin from marketplace
• Features: Interactive diffs, auto-shares current file/selection, quick launch

# Build & Test
- Test: `npm test`
- Build: `npm run build`

# Conventions
- TypeScript strict mode
- 100-char line limit
- Tests required for features

• Cost tracking with /cost command
• SOC-2 compliant with enterprise deployment options
• Integrations: Jira, Notion, Slack, GitHub
• MCP (Model Context Protocol) support
• Transparent review workflow for every change

​

Resources

• Documentation: docs.factory.ai
• BYOK Configuration: docs.factory.ai/cli/byok/overview
• Support: support@factory.ai