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.

• Website: https://factory.ai/product/cli
• Quickstart: https://docs.factory.ai/cli/getting-started/quickstart

Prerequisites

Item	Requirement
Droid CLI	latest
WRouter	A working sk- token
Factory account	Free login required by Factory itself

Install

macOS / Linux

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

Windows (PowerShell)

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

Configure

Droid CLI reads model provider settings from a config file in ~/.factory/. Add a WRouter provider pointing at https://wrouter.ai/v1:

[providers.wrouter]
type      = "openai"
base_url  = "https://wrouter.ai/v1"
api_key   = "${WROUTER_API_KEY}"

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

Then set the API key:

# macOS / Linux
export WROUTER_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Windows PowerShell
$env:WROUTER_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

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 WRouter provider and prompt.

Recommended models

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

Troubleshooting

Symptom	Fix
permission denied during install on Windows	Run PowerShell as administrator, or set npm prefix to your user dir
Login loop	Factory 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 WRouter.