Factory Droid CLI¶

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.

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

Demonstration¶

Features¶

Category	Feature	Value/Capability	Example/Notes
Quick Start & CLI	30-second installation; launch droid interactive session in the project directory; supports macOS/Linux and Windows	Rapid integration into the current project, no new tools required	Windows Installation: `irm https://app.factory.ai/cli/windows \| iex`; Launch: `droid`
End-to-End Feature Development	Full-process automation from planning to implementation to testing; transparent review process	Increase delivery speed while maintaining human control	Native diff viewing and approval workflow (see "Transparency and Control")
Deep Codebase Understanding	Integrates shared organizational knowledge across codebases, documentation, and issue tracking; context-aware, performance improves over time	More accurate suggestions and changes	Continuously leverages knowledge across repositories and documentation
Engineering System Integration	Natively integrates tools like Jira, Notion, Slack, etc.; development work stays synchronized with team processes	Reduce tool switching and information silos	"etc." indicates more integrations
Production-Grade Automation	Workflows reusable locally and in CI/CD; built-in enterprise-grade security and compliance	Consistency and auditability	Adapts to pipelines and enterprise environments
Enterprise Capabilities	Private deployment options, SOC-2 compliance, air-gapped environments	Meets security and compliance requirements	Prioritizing security and quality
Existing Tool Enhancement	Works in terminals, IDEs, and existing development environments; no need to switch editors or learn new interfaces	Maintain existing work habits, low migration cost	Deep integration with familiar tools
Transparency and Control	Every decision is visible and reviewable; maintain full oversight over code changes; native diff viewing and approval workflow	Reduce risk, enhance controllability	Audit-friendly, traceable
Model Flexibility	Not locked to a single AI provider; select the best model per task; consistent organizational behavior and memory	Optimal choice between performance and cost	Supports multi-model routing
Next Steps and Resources	Quickstart, Common Use Cases, IDE Integration, Configuration, AGENTS.md	Facilitates implementation and practice	See 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 requires modifying the configuration file to use third-party APIs.

Modify Environment Variables

iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.ps1')

4. Start Using Droid CLI¶

You can now start using Droid CLI!

Launch Droid CLI

Launch Droid CLI directly:

# Launch Droid CLI
droid

Use in a specific project:

# Navigate to your project directory
cd C:\path\to\your\project

# Launch Droid CLI
droid

Press Enter to launch Droid CLI

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

5. Windows Common Issues Troubleshooting¶

Error message "permission denied" during installation

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

Run PowerShell as administrator
Or configure npm to use the user directory: npm config set prefix %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

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/修改此处/.local/bin:$PATH' >> ~/.zshrc

source ~/.zshrc

2. Modify Configuration File¶

Droid CLI requires modifying the configuration file to use third-party APIs.

One-Click Configuration File Modification

curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.sh | bash

3. Start Using Droid CLI¶

You can now start using Droid CLI!

Launch Droid CLI

Launch Droid CLI directly:

# Launch Droid CLI
droid

Use in a specific project:

# Navigate to your project directory
cd /path/to/your/project

# Launch Droid CLI
droid

Press Enter to launch Droid CLI

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