📖 Overview
Factory Droid CLI is a command-line AI software-engineering agent from Factory AI. Use it in the terminal to interact with LLMs, build, debug, and refactor code, or create full applications.
⚙️ Connect to BeeHears
BeeHears is a New API–compatible relay. In most apps, fill in the three fields below using a token from the BeeHears console:
| Field | Value |
|---|---|
| API Base URL | https://ai.beehears.com or https://ai.beehears.com/v1 (use the OpenAI-compatible field the app expects) |
| API Key | BeeHears console token (starts with sk-) |
| Model name | A model ID available on your account (list via /v1/models). |
Create a token at https://ai.beehears.com and confirm model access. Never paste secrets into docs or chat.
BeeHears does not own this third-party app. Steps below are adapted from upstream New API docs for BeeHears (ai.beehears.com).
📚 Setup guide
Droid CLI is a command-line tool developed by Factory AI, designed to run as an AI software engineering agent. It allows users to interact with various large language models through 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
Demo
Features
| Category | Feature | Value/Capability | Example/Notes | |
|---|---|---|---|---|
| Quick Start with CLI | 30-second installation; launch droid interactive session in project directory; supports macOS/Linux and Windows | Rapid integration into current projects, 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 | Accelerate delivery, maintain human oversight | Native diff viewing and approval process (see "Transparency and Control") | |
| Deep Codebase Understanding | Integrates organizational shared knowledge from codebases, documentation, issue tracking; context-aware, improves over time | More accurate suggestions and changes | Continuously leverages knowledge across repositories and documents | |
| Engineering System Integration | Native integration with Jira, Notion, Slack, and other tools; 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; enterprise-grade security and compliance built-in | 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 | Prioritizes security and quality | |
| Enhance Existing Tools | Works in terminal, IDE, 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; complete oversight of code changes; native diff viewing and approval workflows | Reduce risk, enhance controllability | Audit-friendly, traceable | |
| Model Flexibility | Not locked to a single AI provider; choose the best model per task; consistent organizational behavior and memory | Optimal choice between performance and cost | Supports multi-model routing |
| Category | Feature | Value/Capability | Example/Notes | |
|---|---|---|---|---|
| Quick Start with CLI | 30-second installation; launch droid interactive session in project directory; supports macOS/Linux and Windows | Rapid integration into current projects, 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 | Accelerate delivery, maintain human oversight | Native diff viewing and approval process (see "Transparency and Control") | |
| Deep Codebase Understanding | Integrates organizational shared knowledge from codebases, documentation, issue tracking; context-aware, improves over time | More accurate suggestions and changes | Continuously leverages knowledge across repositories and documents | |
| Engineering System Integration | Native integration with Jira, Notion, Slack, and other tools; 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; enterprise-grade security and compliance built-in | 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 | Prioritizes security and quality | |
| Enhance Existing Tools | Works in terminal, IDE, 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; complete oversight of code changes; native diff viewing and approval workflows | Reduce risk, enhance controllability | Audit-friendly, traceable | |
| Model Flexibility | Not locked to a single AI provider; choose the best model per task; consistent organizational behavior and memory | Optimal choice between performance and cost | Supports multi-model routing | |
| Next Steps & Resources | Quickstart, Common Use Cases, IDE Integration, Configuration, AGENTS.md | Facilitates adoption and practice | See "Next steps/Additional resources" on the page |
AI Model Configuration Method
Windows Graphical Guide
1. Open Terminal
2. Install Factory Droid CLI
Official one-click installation command:
irm https://app.factory.ai/cli/windows | iex3. Modify Configuration File
Droid CLI requires modifying the configuration file to use third-party APIs.
iex (irm 'https://ai.beehears.com # set Base URL / API Key to BeeHears in Droid config')4. Start Using Droid CLI
Now you can start using Droid CLI!
Launch Droid CLI directly:
droidUse in a specific project:
# Navigate to your project directory
cd C:\path\to\your\project
# Launch Droid CLI
droidPress Enter to launch Droid CLI.
Droid CLI requires users to log in to an official account (free) before use.
5. Windows Common Issues Solution
This is usually a permission issue. Try the following solutions:
* Run PowerShell as an administrator
* Or configure npm to use the user directory: npm config set prefix %APPDATA%\npm
If you encounter an execution policy restriction, run:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUsermacOS/Linux Graphical Guide
1. Install Droid CLI
Open your terminal and run the following command:
curl -fsSL https://app.factory.ai/cli | shFollow the installation prompts to modify environment variables (copy the installation prompt code directly):
For Linux, choose ~/.bashrc or ~/.zshrc as appropriate.
echo ' source ~/.zshrc2. Modify Configuration File
Droid CLI requires modifying the configuration file to use third-party APIs.
curl -fsSL https://ai.beehears.com # set Base URL / API Key to BeeHears in Droid config | bash3. Start Using Droid CLI
Now you can start using Droid CLI!
Launch Droid CLI directly:
droidUse in a specific project:
# Navigate to your project directory
cd /path/to/your/project
# Launch Droid CLI
droidPress Enter to launch Droid CLI.
Droid CLI requires users to log in to an official account (free) before use.