Droid

Droid is the Factory.ai CLI. A single ~/.factory/config.json file lets sessions mix Claude, GPT, Gemini, and any other AI Gateway-supported model, all routed through Orq.ai for unified tracing, cost tracking, and access controls.

Prerequisites

Droid CLI installed
Active Factory.ai account (free tier, no paid subscription required)
Active Orq.ai account
Orq.ai API key

Install Droid CLI

macOS / Linux
Windows

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

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

Setup

Authenticate with Factory

droid login

Clear conflicting environment variables

If ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, or ANTHROPIC_API_KEY are set in your shell, they override config.json and requests bypass Orq.ai. Unset them before running Droid:

unset ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL ANTHROPIC_API_KEY

Edit ~/.factory/config.json

Add a custom_models array with one entry per model. The example below registers Claude, GPT-5.6 Sol, and Gemini all routed through Orq.ai:

{
  "custom_models": [
    {
      "model_display_name": "Claude Sonnet 5 via Orq",
      "model": "anthropic/claude-sonnet-5",
      "base_url": "https://my.orq.ai/v3/anthropic",
      "api_key": "<ORQ_API_KEY>",
      "provider": "anthropic",
      "max_tokens": 64000
    },
    {
      "model_display_name": "GPT-5.6 Sol via Orq",
      "model": "openai/gpt-5.6-sol",
      "base_url": "https://my.orq.ai/v3/router",
      "api_key": "<ORQ_API_KEY>",
      "provider": "generic-chat-completion-api",
      "max_tokens": 16000
    },
    {
      "model_display_name": "Gemini 3.5 Flash via Orq",
      "model": "google/gemini-3.5-flash",
      "base_url": "https://my.orq.ai/v3/router",
      "api_key": "<ORQ_API_KEY>",
      "provider": "generic-chat-completion-api",
      "max_tokens": 8000
    }
  ]
}

Replace <ORQ_API_KEY> with your key from Workspace Settings → API Keys.

Start Droid and select a model

droid

Inside the session, use /model to switch between registered custom models.

Configuration Reference

Provider field

Value	Behavior
`"anthropic"`	Uses the Anthropic SDK, which appends `/v1/messages` to the base URL automatically. Point `base_url` to `https://my.orq.ai/v3/anthropic`.
`"generic-chat-completion-api"`	Uses the OpenAI-compatible Chat Completions format. Point `base_url` to `https://my.orq.ai/v3/router`.
`"openai"`	Hardcoded to `api.openai.com`. Ignores `base_url`. Do not use this value for Orq-routed models.

Base URL by provider type

Provider value	Correct `base_url`
`"anthropic"`	`https://my.orq.ai/v3/anthropic`
`"generic-chat-completion-api"`	`https://my.orq.ai/v3/router`

See the Anthropic Messages API for endpoint details, authentication, and cache_control breakpoints.

Do not use "provider": "openai" for Orq.ai-routed models. It is hardcoded to api.openai.com and ignores base_url, so requests bypass Orq.ai entirely.

Skills

Orq Skills add pre-built agentic workflows to Droid for the full Build, Evaluate, Optimize lifecycle.

Installation

npx skills add orq-ai/assistant-plugins --agent droid

Set an API key and connect the Orq MCP server first. Skills are then triggered by describing what is needed.

Orq Skills

The full catalogue of skills and slash commands.

Slash commands (/orq:quickstart, /orq:traces, and others) are only available in Claude Code.

Troubleshooting

Requests going to api.openai.com instead of Orq

The "provider": "openai" value is hardcoded to api.openai.com and ignores base_url. Change provider to "generic-chat-completion-api" for all Orq-routed OpenAI-compatible models.

Anthropic requests failing or bypassing Orq

Check for conflicting environment variables. If ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, or ANTHROPIC_API_KEY are set, they take precedence over config.json. Run unset ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL ANTHROPIC_API_KEY and restart Droid.

Droid CLI inaccessible after install

Run droid login to authenticate with Factory.ai before using any model. Without a valid session the CLI will not start.

No Traces appearing in Orq.ai

Confirm the api_key value in config.json is a valid Orq.ai API key (not an OpenAI or Anthropic key), and that base_url points to the correct Orq endpoint for the chosen provider type.

Verification

Start a Droid session, select a registered model with /model, and send a prompt. The response appears in the session and the trace appears in Orq.ai Traces with the model identifier (e.g. anthropic/claude-sonnet-5).

Model Providers

Coding Agents

Chat Interfaces

Frameworks & SDKs

Automations

Prerequisites

Install Droid CLI

Setup

Configuration Reference

Provider field

Base URL by provider type

Skills

Installation

Orq Skills

Troubleshooting

Verification

​Prerequisites

​Install Droid CLI

​Setup

​Configuration Reference

​Provider field

​Base URL by provider type

​Skills

​Installation

Orq Skills

​Troubleshooting

​Verification

Prerequisites

Install Droid CLI

Setup

Configuration Reference

Provider field

Base URL by provider type

Skills

Installation

Troubleshooting

Verification