Skip to main content
Factory Droid is an enterprise-grade AI coding agent that lives in your terminal and handles end-to-end development workflows. Works seamlessly with Z.AI’s GLM Coding Plan for high-performance models at exceptional value.

​
Step 1: Installing Factory Droid

macOS / Linux: 
curl -fsSL https://app.factory.ai/cli | sh
Windows: 
irm https://app.factory.ai/cli/windows | iex

​
Step 2: Configuring Z.AI GLM Models

​
1. Get Your Z.AI API Key

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

​
2. Configure Custom Models

Factory Droid uses BYOK (Bring Your Own Key) to connect with Z.AI’s GLM models. Configuration file location
  • macOS/Linux: ~/.factory/config.json
  • Windows: %USERPROFILE%\.factory\config.json
For GLM Coding Plan subscribers: 
{
  "custom_models": [
    {
      "model_display_name": "GLM-4.6 [Z.AI]",
      "model": "glm-4.6",
      "base_url": "https://api.z.ai/api/coding/paas/v4",
      "api_key": "YOUR_ZAI_API_KEY",
      "provider": "generic-chat-completion-api",
      "max_tokens": 204800
    }
  ]
}
For standard Z.AI api users: 
{
  "custom_models": [
    {
      "model_display_name": "GLM-4.5 [Z.AI]",
      "model": "glm-4.6",
      "base_url": "https://api.z.ai/api/paas/v4",
      "api_key": "YOUR_ZAI_API_KEY",
      "provider": "generic-chat-completion-api",
      "max_tokens": 204800
    }
  ]
}
Important notes
  • GLM Coding Plan users must use the Coding API endpoint: https://api.z.ai/api/coding/paas/v4
  • Standard plan users use the common API endpoint: https://api.z.ai/api/paas/v4
  • Replace YOUR_ZAI_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

Navigate to your project directory and start droid: 
cd /path/to/your/project
droid
On first launch, you’ll be prompted to sign in via your browser to connect to Factory’s services.

​
2. Select Your Z.AI Model

Once droid is running, use the /model command to select your Z.AI GLM model: 
/model
Your custom Z.AI models will appear in a separate “Custom models” section. Select the GLM model you configured.

​
3. Start Coding

Use droid for tasks like analyzing code, implementing features, fixing bugs, reviewing changes, and more.

​
Key Features

Specification Mode
  • Press Shift+Tab to activate
  • Describe features in plain language
  • Get automatic planning before implementation
  • Approve plans before any code changes
Auto-Run Mode
  • 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
IDE Integration
  • 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
AGENTS.md — Project Conventions Document your workflow at repo root: 
# Build & Test
- Test: `npm test`
- Build: `npm run build`

# Conventions
- TypeScript strict mode
- 100-char line limit
- Tests required for features
Droid automatically follows your team’s practices. Additional 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

⌘I