Droid Paperclip Adapter

Paperclip adapter for Factory Droid — run Droid as a managed employee in a Paperclip company.

Installation

Via npm (requires Paperclip adapter plugin system)

# In the Paperclip UI: Settings → Adapters → Install → "@henkey/droid-paperclip-adapter"
# Or via API:
curl -X POST http://localhost:3102/api/adapters/install \
  -H "Content-Type: application/json" \
  -d '{"packageName": "@henkey/droid-paperclip-adapter"}'

Via local path (development)

curl -X POST http://localhost:3102/api/adapters/install \
  -H "Content-Type: application/json" \
  -d '{"packageName": "/path/to/droid-paperclip-adapter", "isLocalPath": true}'

Prerequisites

• Factory Droid CLI installed and authenticated
• FACTORY_API_KEY set in environment or adapter config
• Paperclip with the external adapter plugin system support

Configuration

| Field | Type | Default | Description | |-------|------|---------|-------------| | cwd | string | (none) | Working directory for Droid | | model | string | (Droid default) | Droid model ID | | effort | string | (none) | Reasoning effort (--reasoning-effort) | | command | string | droid | Path to Droid CLI binary | | extraArgs | string[] | [] | Additional CLI arguments | | env | object | {} | Environment variables | | timeoutSec | number | 300 | Execution timeout in seconds | | graceSec | number | 10 | Grace period after SIGTERM | | promptTemplate | string | (default) | Custom prompt template with {{variable}} placeholders | | instructionsFilePath | string | (none) | Path to markdown instructions file | | persistSession | boolean | true | Resume sessions across heartbeats |

How It Works

Paperclip runs Droid via:

droid exec --cwd <path> --output-format stream-json

Prompt content is piped over stdin. Output is structured JSON (one event per line) — tool calls, tool results, assistant messages, and usage metrics are all parsed automatically.

Development

npm install
npm run build
npm run typecheck

License

MIT