Downsizing logodownsizing
Documentation

Using Downsizing with Droid

Route Droid (Factory AI's terminal coding agent) traffic through Downsizing using its Bring-Your-Own-Key custom model support.


Prerequisites

Sign in to Droid with your Factory account — that login is separate from, and required before, the custom model setup below. Install the Downsizing CLI — see the CLI guide if you haven't already.

Link Droid (Recommended)

Link Droid to Downsizing:

bash
ds link droid

This writes a customModelsentry (Factory's documented Bring-Your-Own-Key mechanism) into ~/.factory/settings.json, using the native Anthropic Messages API — not the OpenAI Chat Completions API. It's idempotent — safe to run again any time, and only ever touches the single entry it owns, leaving the rest of your settings file untouched.

Select the model

Inside a Droid session, open the model picker and choose the Downsizing entry:

bash
/model
# choose: downsizing-claude-opus-4-8

Or pass it directly on the command line:

bash
droid exec --model downsizing-claude-opus-4-8 "hello"

Manual Setup

If you prefer to configure manually, edit ~/.factory/settings.json and add:

json
{
  "customModels": [
    {
      "model": "downsizing-claude-opus-4-8",
      "displayName": "Downsizing",
      "baseUrl": "https://api.downsizing.dev/YOUR_INFERENCE_ID/anthropic/v1",
      "apiKey": "dws_YOUR_API_KEY",
      "provider": "anthropic",
      "maxOutputTokens": 16384
    }
  ]
}

Find your Inference ID and API key on the Inference API page.

Verify

Run a quick one-shot query to confirm traffic is routing through Downsizing:

bash
droid exec --model downsizing-claude-opus-4-8 "hello"

If Droid responds, Downsizing is set up correctly. You can also check your savings dashboard to see the request appear in your usage metrics.

Unlinking

To remove Downsizing from Droid:

bash
ds unlink droid

Spot an error or something not working? Tell us on Discord or email docs@downsizing.dev.