Skip to content

Factory Droid CLI ​

Factory Droid CLI is an AI software engineering assistant from Factory AI — full lifecycle automation from planning to test, running as an agent in your terminal.

Prerequisites ​

ItemRequirement
Droid CLIlatest
AccelsRouterA working sk- token
Factory accountFree login required by Factory itself

Install ​

macOS / Linux ​

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

Windows (PowerShell) ​

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

Configure ​

Droid CLI reads model provider settings from a config file in ~/.factory/. Add a AccelsRouter provider pointing at https://router.accels.tech/v1:

toml
[providers.accelsrouter]
type      = "openai"
base_url  = "https://router.accels.tech/v1"
api_key   = "${ACCELSROUTER_API_KEY}"

[providers.accelsrouter.models.claude-sonnet]
id      = "claude-sonnet-4-6"
context = 200000
output  = 32768

Then set the API key:

bash
# macOS / Linux
export ACCELSROUTER_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Windows PowerShell
$env:ACCELSROUTER_API_KEY="sk-xxxx..."

Field names in the config file follow Droid's current schema — refer to Factory's official docs for exact spelling.

Verify ​

bash
cd path/to/your/project
droid

You must be logged in to a Factory account (free) before Droid will start. Once started, point it at your AccelsRouter provider and prompt.

ModelUse
claude-sonnet-4-6General engineering tasks
claude-opus-4-8Complex refactors / planning
gpt-5.5Reasoning-heavy debugging

Troubleshooting ​

SymptomFix
permission denied during install on WindowsRun PowerShell as administrator, or set npm prefix to your user dir
Login loopFactory requires its own account regardless of model provider

Known limitations ​

  • Some Droid enterprise features (Jira / Notion / Slack integrations, SOC-2 reports) ship from Factory's cloud, not AccelsRouter.