88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support

Factory Droid CLI


WindowsmacOSLinux

Project Introduction

Command Line: Automation Across the SDLC. Script and parallelize Droids at massive scale for CI/CD, migrations, and maintenance. From automated code review to self-healing builds, integrate agents into every phase of development.

Droid CLI is a command-line tool developed by Factory AI, designed to operate as an AI software engineering agent. It allows users to interact with various large language models via the terminal, build, debug, and refactor code, and even create complete applications.

  1. Official Homepage: https://factory.ai/product/cli
  2. Official Documentation: https://docs.factory.ai/cli/getting-started/quickstart
  3. Installation Method: See the tutorial below on this page

Demonstration


droid.webp

Features

CategoryFeatureValue/CapabilityExample/Notes
Quick Start & CLI30-second installation; launch droid interactive session in the project directory; supports macOS/Linux and WindowsRapid integration into the current project, no new tools requiredWindows Installation: irm https://app.factory.ai/cli/windows | iex; Launch: droid
End-to-End Feature DevelopmentFull-process automation from planning to implementation to testing; transparent review processIncrease delivery speed while maintaining human controlNative diff viewing and approval workflow (see "Transparency and Control")
Deep Codebase UnderstandingIntegrates shared organizational knowledge across codebases, documentation, and issue tracking; context-aware, performance improves over timeMore accurate suggestions and changesContinuously leverages knowledge across repositories and documentation
Engineering System IntegrationNatively integrates tools like Jira, Notion, Slack, etc.; development work stays synchronized with team processesReduce tool switching and information silos"etc." indicates more integrations
Production-Grade AutomationWorkflows reusable locally and in CI/CD; built-in enterprise-grade security and complianceConsistency and auditabilityAdapts to pipelines and enterprise environments
Enterprise CapabilitiesPrivate deployment options, SOC-2 compliance, air-gapped environmentsMeets security and compliance requirementsPrioritizing security and quality
Existing Tool EnhancementWorks in terminals, IDEs, and existing development environments; no need to switch editors or learn new interfacesMaintain existing work habits, low migration costDeep integration with familiar tools
Transparency and ControlEvery decision is visible and reviewable; maintain full oversight over code changes; native diff viewing and approval workflowReduce risk, enhance controllabilityAudit-friendly, traceable
Model FlexibilityNot locked to a single AI provider; select the best model per task; consistent organizational behavior and memoryOptimal choice between performance and costSupports multi-model routing
Next Steps and ResourcesQuickstart, Common Use Cases, IDE Integration, Configuration, AGENTS.mdFacilitates implementation and practiceSee page “Next steps/Additional resources”

AI Model Configuration Method

Windows Graphical Guide

1. Open Terminal

windows_open_terminal

2. Install Factory Droid CLI

Official one-click installation command:

One-Click Installation Command

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

windows-install

3. Modify Configuration File

Droid CLI connects to third-party APIs through custom models (BYOK). The one-click script merges the 88API models into customModels in ~/.factory/settings.json (the location Factory currently documents): it only replaces models whose name contains [88API], keeps your other settings and custom models, and backs up the original file as settings.json.bak.<timestamp>. 88API models that older versions of the script wrote to ~/.factory/config.json are removed as well. Models written:

  • GPT models (gpt-6.1-sol, gpt-6-astra): provider openai, Base URL https://api.88api.ai/v1
  • Claude models (claude-fable-5-1, claude-opus-5-5, claude-sonnet-5-5): provider anthropic, Base URL https://api.88api.ai (without /v1)

windows-configure.webp

The script's prompts are in Chinese; the values are the same as in the text.

One-Click Configuration File Modification

iex (irm 'https://88api.ai/helper/factory-cli-setup.ps1')

Follow the prompts: press Enter at Base URL (default https://api.88api.ai). The script handles the two model types separately: GPT models get https://api.88api.ai/v1, Claude models get https://api.88api.ai (without /v1). Then paste the API key created in the 88API console at API Key (the input is not shown in plain text). To change the API key later, just run the script again.

4. Start Using Droid CLI

You can now start using Droid CLI!

# Go to your project directory (optional)
cd C:\path\to\your\project
# Launch Droid CLI
droid

Switch to an 88API Model

After starting droid, type /model and choose a model marked [88API] in the Custom models section below the list (for example GPT-6.1 Sol [88API] or Claude Opus 5.5 [88API]). If you do not switch, Droid uses Factory's own models and requests do not go through 88API. To use Claude models, the group of your 88API key must include those Claude models.

Droid CLI requires users to log in to an official account (free) before use.

5. Windows Common Issues Troubleshooting

permission denied error during installation

This is usually a permission issue. Try the following solutions:

  • Run PowerShell as administrator, then run the installation command again

  • If you install with npm instead, configure npm to use the user directory: npm config set prefix "$env:APPDATA\npm"

PowerShell Execution Policy Error

If you encounter execution policy restrictions, run: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

macOS/Linux Graphical Guide

1. Install Droid CLI

Install Droid CLI

Open the terminal and run the following command: curl -fsSL https://app.factory.ai/cli | sh

macos-open-terminal

macos-img-02.webp

Modify environment variables according to the installation prompts (copy the installation prompt code directly):

For Linux, choose ~/.bashrc or ~/.zshrc as appropriate.

Droid CLI Environment Variables (Example Only)

echo 'export PATH=/Users/YOUR_USERNAME/.local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

2. Modify Configuration File

Droid CLI connects to third-party APIs through custom models (BYOK). The one-click script merges the 88API models into customModels in ~/.factory/settings.json (the location Factory currently documents): it only replaces models whose name contains [88API], keeps your other settings and custom models, and backs up the original file as settings.json.bak.<timestamp>. 88API models that older versions of the script wrote to ~/.factory/config.json are removed as well. Models written:

  • GPT models (gpt-6.1-sol, gpt-6-astra): provider openai, Base URL https://api.88api.ai/v1
  • Claude models (claude-fable-5-1, claude-opus-5-5, claude-sonnet-5-5): provider anthropic, Base URL https://api.88api.ai (without /v1)

One-Click Configuration File Modification

curl -fsSL https://88api.ai/helper/factory-cli-setup.sh | bash

Follow the prompts: press Enter at Base URL (default https://api.88api.ai). The script handles the two model types separately: GPT models get https://api.88api.ai/v1, Claude models get https://api.88api.ai (without /v1). Then paste the API key created in the 88API console at API Key (the input is not shown in plain text). To change the API key later, just run the script again.

macos-img-03.webp

The script's prompts are in Chinese; the values are the same as in the text.

3. Start Using Droid CLI

You can now start using Droid CLI!

# Go to your project directory (optional)
cd /path/to/your/project
# Launch Droid CLI
droid

Switch to an 88API Model

After starting droid, type /model and choose a model marked [88API] in the Custom models section below the list (for example GPT-6.1 Sol [88API] or Claude Opus 5.5 [88API]). If you do not switch, Droid uses Factory's own models and requests do not go through 88API. To use Claude models, the group of your 88API key must include those Claude models.

Droid CLI requires users to log in to an official account (free) before use.

Manual Configuration (Optional)

Without the one-click script, you can add 88API models manually to the customModels array in ~/.factory/settings.json (on Windows: %USERPROFILE%\.factory\settings.json). If the file already exists, merge only customModels and keep your other settings:

{
  "customModels": [
    {
      "model": "gpt-6.1-sol",
      "displayName": "GPT-6.1 Sol [88API]",
      "baseUrl": "https://api.88api.ai/v1",
      "apiKey": "sk-your-88api-key",
      "provider": "openai",
      "maxOutputTokens": 128000
    },
    {
      "model": "claude-opus-5-5",
      "displayName": "Claude Opus 5.5 [88API]",
      "baseUrl": "https://api.88api.ai",
      "apiKey": "sk-your-88api-key",
      "provider": "anthropic",
      "maxOutputTokens": 32000
    }
  ]
}

Note: with provider openai, baseUrl must include /v1; with provider anthropic, use https://api.88api.ai (without /v1). After saving, restart droid and select the model with /model.

~/.factory/config.json (snake_case fields such as custom_models and base_url) is Factory's legacy format: when Droid starts it copies those models into settings.json, and later edits to config.json are ignored. Use settings.json.