​

Droid Adapter

​

Quick Start

# Run with explicit target flag
ccs glm --target droid

# Use built-in alias (ccsd = droid target)
ccsd glm "your prompt"

# Custom aliases via env var
export CCS_DROID_ALIASES=mydroid,alt-droid
mydroid glm "your prompt"

​

Target Resolution Priority

​

Built-in Aliases

# Create ccsd symlink
ln -s $(which ccs) /usr/local/bin/ccsd

# Then use directly
ccsd glm "your prompt"   # Equivalent to: ccs glm --target droid

​

Custom Aliases via CCS_DROID_ALIASES

export CCS_DROID_ALIASES=mydroid,alt-droid,factory-ccs
mydroid glm "prompt"      # Routes to droid
alt-droid codex "prompt"  # Also routes to droid

​

Droid Detection

1. CCS_DROID_PATH env var — explicit path override
2. PATH lookup via which droid (Unix) or where.exe droid (Windows)

npm i -g @factory/cli

​

Environment Variables

​

Config Integration

• Profiles stored as customModels[] entries with CCS -prefixed display names
• Atomic file writes via temp file + rename
• File locking prevents concurrent write races
• Profile names validated: alphanumeric, underscore, and hyphen only

​

Per-Profile Target Config

# API profile
profiles:
  my-api:
    provider: openai
    target: droid    # Always use Droid for this profile

# CLIProxy variant
cliproxy:
  variants:
    my-variant:
      provider: gemini
      target: droid    # Routes this variant to Droid CLI

# Composite variant
cliproxy:
  variants:
    my-composite:
      composite: true
      opus: gemini
      sonnet: agy
      target: droid    # Routes composite to Droid CLI

​

Unsupported Profile Types

​

Dashboard: Droid Page

​

Overview Tab

• Binary detection — shows whether Droid CLI is installed and its path
• File status — checks ~/.factory/settings.json existence and validity
• Warnings — alerts for missing binary, corrupt config, or stale locks
• Auto-refreshes diagnostics every 10 seconds

​

BYOK Tab (Bring Your Own Key)

• Toggle settings like enableThinking, enableArtifacts
• Configure default model selection

• Per-model reasoning effort settings
• Provider-specific configuration:
  • Anthropic: thinking.budget_tokens (4K-64K tokens)
  • OpenAI: reasoning.effort (low/medium/high/max/xhigh)
  • Generic: reasoning_effort (string value)

• CCS-managed models (prefixed “CCS ”) registered in ~/.factory/settings.json
• Three provider types supported:
  • anthropic — Anthropic Messages API
  • openai — OpenAI Responses API
  • generic-chat-completion-api — OpenAI-compatible (Groq, DeepInfra, Ollama, local)
• Smart provider detection: explicit hint → URL inference → model name inference

• Direct editing of ~/.factory/settings.json
• Conflict detection via mtime comparison (prevents overwriting external changes)

​

Docs Tab

• Links to Factory Droid documentation
• Provider API references
• Quick access to relevant CCS docs

​

Reasoning Effort Sync

# CLI override flags
ccs glm --target droid --thinking high
ccs km --target droid --effort medium

​

Security

• No symlink traversal — refuses read/write if target is symlink
• Atomic writes — temp file + rename prevents corruption
• File locking — 10s stale timeout, exponential backoff
• Corruption backup — .bak file created before writes
• File permissions — 0o600 (user-only read/write)

​

Usage Examples

ccs glm --target droid    # Run GLM on Droid (explicit flag)
ccs km --target droid     # Run Kimi for Coding on Droid
ccsd glm                   # Same via ccsd alias
ccs glm                    # Run GLM on Claude (default)
ccsd codex "prompt"        # Run Codex on Droid
ccsd km "prompt"           # Run Kimi API profile on Droid

​

Related

• Dashboard — Visual configuration interface
• Updates Center — Rollout tasks for Droid setup
• Extended Thinking — Thinking/reasoning budget configuration