@swarmclawai/swarmclaw 1.5.35 → 1.5.37

package/README.md

@@ -40,6 +40,7 @@ Extension tutorial: https://swarmclaw.ai/docs/extension-tutorial
   <td align="center"><img src="doc/assets/logos/gemini-cli.svg" width="32" alt="Gemini CLI"><br><sub>Gemini CLI</sub></td>
   <td align="center"><img src="doc/assets/logos/opencode.svg" width="32" alt="OpenCode"><br><sub>OpenCode</sub></td>
   <td align="center"><img src="doc/assets/logos/copilot-cli.svg" width="32" alt="Copilot CLI"><br><sub>Copilot</sub></td>
+  <td align="center"><img src="public/provider-logos/droid-cli.svg" width="32" alt="Factory Droid CLI"><br><sub>Droid</sub></td>
   <td align="center"><img src="doc/assets/logos/cursor-cli.svg" width="32" alt="Cursor Agent CLI"><br><sub>Cursor</sub></td>
   <td align="center"><img src="doc/assets/logos/qwen-code-cli.svg" width="32" alt="Qwen Code CLI"><br><sub>Qwen Code</sub></td>
   <td align="center"><img src="doc/assets/logos/goose.svg" width="32" alt="Goose"><br><sub>Goose</sub></td>
@@ -65,10 +66,23 @@ Extension tutorial: https://swarmclaw.ai/docs/extension-tutorial
 - Node.js 22.6+ (`nvm use` will pick up the repo's `.nvmrc`, which matches CI)
 - npm 10+ or another supported package manager
 - Docker Desktop is recommended for sandbox browser execution
-- Optional provider CLIs if you want delegated CLI backends such as Claude Code, Codex, OpenCode, Gemini, Copilot, Cursor Agent, Qwen Code, or Goose
+- Optional provider CLIs if you want delegated CLI backends such as Claude Code, Codex, OpenCode, Gemini, Copilot, Factory Droid, Cursor Agent, Qwen Code, or Goose
 
 ## Quick Start
 
+### Desktop app (recommended for non-technical users)
+
+Download the one-click installer from [swarmclaw.ai/downloads](https://swarmclaw.ai/downloads).
+Available for macOS (Apple Silicon & Intel), Windows, and Linux (AppImage + .deb).
+
+Current builds are unsigned, so on first launch:
+- **macOS:** right-click the app in Finder → **Open** → **Open** to bypass Gatekeeper.
+- **Windows:** if SmartScreen appears, click **More info** → **Run anyway**.
+- **Linux (AppImage):** `chmod +x` the downloaded file, then run it.
+
+Data lives in your OS app-data directory (`~/Library/Application Support/SwarmClaw`,
+`%APPDATA%\SwarmClaw`, or `~/.config/SwarmClaw`), separate from any CLI or Docker install.
+
 ### Global install
 
 ```bash
@@ -375,6 +389,20 @@ Operational docs: https://swarmclaw.ai/docs/observability
 
 ## Releases
 
+### v1.5.37 Highlights
+
+- **Factory Droid CLI as a provider and delegation backend**: adds [`droid`](https://docs.factory.ai/cli/droid-exec/overview) as a first-class chat provider and `delegate` backend with streaming JSON output, session resume, and a conservative `--auto low` autonomy pin on the delegate path. Install `droid` and sign in via browser (or set `FACTORY_API_KEY`), then pick **Factory Droid CLI** in the setup wizard. Resolves #38.
+- **Desktop Release CI hardening**: v1.5.36's Electron build workflow failed on all three platforms. This release:
+  - Adds a proper `author` with email to `package.json` and a `linux.maintainer` entry in `electron-builder.yml` so the Linux `.deb` target stops rejecting the build.
+  - Pins `outputFileTracingRoot` in `next.config.ts` to the project root so the Next.js build no longer walks `C:\Users\<user>\Application Data` (a legacy NTFS junction that throws EPERM on Windows runners).
+  - Pins Python 3.11 in the desktop-release workflow so `node-gyp` rebuilds of native modules (`node-liblzma`, etc.) succeed on Python 3.12+ runners where `distutils` was removed from the stdlib.
+
+### v1.5.36 Highlights
+
+- **Desktop app (Electron)**: SwarmClaw now ships as a native desktop app for macOS (Apple Silicon + Intel), Windows, and Linux (AppImage + .deb). Download from [swarmclaw.ai/downloads](https://swarmclaw.ai/downloads). The app wraps the existing standalone server inside an Electron shell, stores data in the OS app-data directory, and auto-updates via GitHub Releases (notify-only on unsigned macOS builds).
+- **Desktop release CI**: new `desktop-release.yml` workflow builds and publishes installers for all three platforms to GitHub Releases on every version tag.
+- **UI cleanup**: removed sibling-product navigation links from the in-app sidebar rail and login gate so the open-source app focuses on SwarmClaw itself. Those links remain in the project README and on swarmclaw.ai.
+
 ### v1.5.35 Highlights
 
 - **Update safety: prevent DB corruption on Linux**: `npm run update:easy`, `swarmclaw update`, and the in-app update endpoint now stop the running server (or checkpoint the SQLite WAL) before rebuilding native modules, preventing the WAL journal corruption that forced some Linux users back to the setup wizard.

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "@swarmclawai/swarmclaw",
-  "version": "1.5.35",
+  "version": "1.5.37",
   "description": "Build and run autonomous AI agents with OpenClaw, Hermes, multiple model providers, orchestration, delegation, memory, skills, schedules, and chat connectors.",
+  "main": "electron-dist/main.js",
   "license": "MIT",
+  "author": {
+    "name": "SwarmClaw",
+    "email": "noreply@swarmclaw.ai",
+    "url": "https://swarmclaw.ai"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -78,6 +84,13 @@
     "test:builder": "tsx --test src/features/protocols/builder/utils/nodes-to-template.test.ts src/features/protocols/builder/utils/template-to-nodes.test.ts src/features/protocols/builder/validators/dag-validator.test.ts",
     "test:e2e": "tsx .workbench/browser-e2e/run.ts",
     "test:mcp:conformance": "node --import tsx ./scripts/mcp-conformance-check.ts",
+    "electron:compile": "tsc -p electron/tsconfig.json",
+    "electron:dev": "npm run electron:compile && electron electron-dist/main.js",
+    "electron:build": "node ./scripts/build-electron.mjs",
+    "electron:build:mac": "node ./scripts/build-electron.mjs --mac",
+    "electron:build:win": "node ./scripts/build-electron.mjs --win",
+    "electron:build:linux": "node ./scripts/build-electron.mjs --linux",
+    "electron:build:publish": "node ./scripts/build-electron.mjs --publish",
     "prepack": "npm run build:ci",
     "postinstall": "node ./scripts/postinstall.mjs"
   },
@@ -114,6 +127,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "commander": "^13.1.0",
+    "electron-updater": "^6.3.9",
     "cron-parser": "^5.5.0",
     "cronstrue": "^3.12.0",
     "dagre": "^0.8.5",
@@ -156,7 +170,10 @@
     "zustand": "^5.0.11"
   },
   "devDependencies": {
+    "@electron/rebuild": "^3.7.2",
     "@types/dagre": "^0.7.54",
+    "electron": "^33.3.0",
+    "electron-builder": "^25.1.8",
     "eslint": "^9",
     "eslint-config-next": "16.1.7"
   },

package/public/provider-logos/droid-cli.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Factory Droid CLI">
+  <rect x="2" y="2" width="60" height="60" rx="14" fill="#0f172a"/>
+  <rect x="2" y="2" width="60" height="60" rx="14" fill="none" stroke="#38bdf8" stroke-width="2"/>
+  <path d="M20 22 h24 v6 h-9 v16 h-6 v-16 h-9 z" fill="#e2e8f0"/>
+  <circle cx="16" cy="48" r="2.5" fill="#38bdf8"/>
+  <circle cx="48" cy="48" r="2.5" fill="#38bdf8"/>
+</svg>

package/src/app/api/setup/check-provider/route.ts

@@ -12,6 +12,7 @@ type SetupProvider =
   | 'opencode-cli'
   | 'gemini-cli'
   | 'copilot-cli'
+  | 'droid-cli'
   | 'cursor-cli'
   | 'qwen-code-cli'
   | 'goose'
@@ -31,7 +32,7 @@ type SetupProvider =
   | 'openclaw'
   | 'hermes'
 
-type CliSetupProvider = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'gemini-cli' | 'copilot-cli' | 'cursor-cli' | 'qwen-code-cli' | 'goose'
+type CliSetupProvider = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'gemini-cli' | 'copilot-cli' | 'droid-cli' | 'cursor-cli' | 'qwen-code-cli' | 'goose'
 
 interface SetupCheckBody {
   provider?: string
@@ -285,6 +286,7 @@ function checkCliProvider(provider: CliSetupProvider): { ok: boolean; message: s
     'opencode-cli': { binary: 'opencode', backend: 'opencode' as const, label: 'OpenCode CLI' },
     'gemini-cli': { binary: 'gemini', backend: 'gemini' as const, label: 'Gemini CLI' },
     'copilot-cli': { binary: 'copilot', backend: 'copilot' as const, label: 'GitHub Copilot CLI' },
+    'droid-cli': { binary: 'droid', backend: 'droid' as const, label: 'Factory Droid CLI' },
     'cursor-cli': { binary: 'cursor-agent', backend: 'cursor' as const, label: 'Cursor Agent CLI' },
     'qwen-code-cli': { binary: 'qwen', backend: 'qwen' as const, label: 'Qwen Code CLI' },
     goose: { binary: 'goose', backend: 'goose' as const, label: 'Goose CLI' },
@@ -312,7 +314,7 @@ export async function POST(req: Request) {
   const credentialId = clean(body.credentialId)
   const endpoint = clean(body.endpoint)
   const model = clean(body.model)
-  const CLI_PROVIDERS = new Set<CliSetupProvider>(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'cursor-cli', 'qwen-code-cli', 'goose'])
+  const CLI_PROVIDERS = new Set<CliSetupProvider>(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli', 'goose'])
 
   // Resolve credentialId to an API key if no raw key was provided
   if (!apiKey && credentialId) {

package/src/app/api/setup/doctor/route.ts

@@ -203,6 +203,7 @@ export async function GET(req: Request) {
     { id: 'opencode-cli', label: 'OpenCode CLI', command: 'opencode' },
     { id: 'gemini-cli', label: 'Gemini CLI', command: 'gemini' },
     { id: 'copilot-cli', label: 'GitHub Copilot CLI', command: 'copilot' },
+    { id: 'droid-cli', label: 'Factory Droid CLI', command: 'droid' },
     { id: 'cursor-cli', label: 'Cursor Agent CLI', command: 'cursor-agent' },
     { id: 'qwen-code-cli', label: 'Qwen Code CLI', command: 'qwen' },
     { id: 'goose', label: 'Goose CLI', command: 'goose' },

package/src/components/agents/agent-sheet.tsx

@@ -2513,7 +2513,9 @@ export function AgentSheet() {
                     ? 'Gemini CLI uses its own built-in tools and runtime — SwarmClaw does not inject local platform tools for it.'
                     : provider === 'copilot-cli'
                       ? 'GitHub Copilot CLI uses its own built-in tools and runtime — SwarmClaw does not inject local platform tools for it.'
-                      : provider === 'cursor-cli'
+                      : provider === 'droid-cli'
+                        ? 'Factory Droid CLI uses its own built-in tools and autonomy controls — SwarmClaw does not inject local platform tools for it.'
+                        : provider === 'cursor-cli'
                         ? 'Cursor Agent CLI runs with its own native tool/runtime layer — SwarmClaw sends prompts directly without injecting local platform tools.'
                         : provider === 'qwen-code-cli'
                           ? 'Qwen Code CLI uses its own native tools and runtime — SwarmClaw does not inject local platform tools for it.'

package/src/components/agents/inspector-panel.tsx

@@ -53,6 +53,7 @@ const PROVIDER_LABELS: Record<string, string> = {
   'opencode-cli': 'OpenCode CLI',
   'gemini-cli': 'Gemini CLI',
   'copilot-cli': 'Copilot CLI',
+  'droid-cli': 'Droid CLI',
   'cursor-cli': 'Cursor CLI',
   'qwen-code-cli': 'Qwen Code CLI',
   goose: 'Goose',

package/src/components/auth/access-key-gate.tsx

@@ -9,11 +9,6 @@ interface AccessKeyGateProps {
 }
 
 const AUTH_CHECK_TIMEOUT_MS = 8_000
-const NETWORK_LINKS = [
-  { href: 'https://www.swarmdock.ai', label: 'SwarmDock' },
-  { href: 'https://swarmrecall.ai', label: 'SwarmRecall' },
-  { href: 'https://swarmrelay.ai', label: 'SwarmRelay' },
-]
 
 function isExpectedAuthCheckError(err: unknown): boolean {
   return isAbortError(err) || isTimeoutError(err)
@@ -427,25 +422,6 @@ export function AccessKeyGate({ onAuthenticated }: AccessKeyGateProps) {
           </>
         )}
 
-        <div className="mt-10 border-t border-white/[0.06] pt-5" style={{ animation: 'fade-up 0.6s var(--ease-spring) 0.35s both' }}>
-          <p className="text-[10px] font-700 uppercase tracking-[0.18em] text-text-3/55">
-            Network
-          </p>
-          <div className="mt-3 flex flex-wrap items-center justify-center gap-2.5">
-            {NETWORK_LINKS.map((link) => (
-              <a
-                key={link.href}
-                href={link.href}
-                target="_blank"
-                rel="noopener noreferrer"
-                className="rounded-full border border-white/[0.08] bg-white/[0.03] px-3 py-1.5 text-[12px] text-text-3
-                  no-underline transition-all duration-200 hover:border-white/[0.14] hover:bg-white/[0.06] hover:text-text"
-              >
-                {link.label}
-              </a>
-            ))}
-          </div>
-        </div>
       </div>
     </div>
   )

package/src/components/chat/activity-moment.tsx

@@ -14,6 +14,7 @@ const NOTABLE_TOOLS: Record<string, { label: string; color: string; icon: 'brain
   delegate_to_opencode_cli: { label: 'Delegated to OpenCode', color: '#38BDF8', icon: 'delegate' },
   delegate_to_gemini_cli: { label: 'Delegated to Gemini CLI', color: '#38BDF8', icon: 'delegate' },
   delegate_to_cursor_cli: { label: 'Delegated to Cursor CLI', color: '#38BDF8', icon: 'delegate' },
+  delegate_to_droid_cli: { label: 'Delegated to Factory Droid', color: '#38BDF8', icon: 'delegate' },
   delegate_to_qwen_code_cli: { label: 'Delegated to Qwen Code', color: '#38BDF8', icon: 'delegate' },
   delegate_to_agent: { label: 'Delegating task', color: '#6366F1', icon: 'delegate' },
   check_delegation_status: { label: 'Checking delegation', color: '#6366F1', icon: 'delegate' },

package/src/components/chat/chat-header.tsx

@@ -220,10 +220,11 @@ export function ChatHeader({ session, streaming, onStop, onMenuToggle, onBack, m
         opencodeSessionId: null,
         geminiSessionId: null,
         copilotSessionId: null,
+        droidSessionId: null,
         cursorSessionId: null,
         qwenSessionId: null,
         acpSessionId: null,
-        delegateResumeIds: { claudeCode: null, codex: null, opencode: null, gemini: null, copilot: null, cursor: null, qwen: null },
+        delegateResumeIds: { claudeCode: null, codex: null, opencode: null, gemini: null, copilot: null, droid: null, cursor: null, qwen: null },
       })
       await refreshSession(session.id)
     } catch { /* best-effort */ }

package/src/components/chat/tool-call-bubble.tsx

@@ -28,6 +28,7 @@ const TOOL_COLORS: Record<string, string> = {
   delegate_to_opencode_cli: '#14B8A6',
   delegate_to_gemini_cli: '#2563EB',
   delegate_to_copilot_cli: '#6366F1',
+  delegate_to_droid_cli: '#A855F7',
   delegate_to_cursor_cli: '#F97316',
   delegate_to_qwen_code_cli: '#22C55E',
   whoami_tool: '#8B5CF6',
@@ -81,6 +82,7 @@ export const TOOL_LABELS: Record<string, string> = {
   opencode_cli: 'OpenCode CLI',
   gemini_cli: 'Gemini CLI',
   copilot_cli: 'Copilot CLI',
+  droid_cli: 'Factory Droid',
   cursor_cli: 'Cursor CLI',
   qwen_code_cli: 'Qwen Code CLI',
   spawn_subagent: 'Subagent',
@@ -91,6 +93,7 @@ export const TOOL_LABELS: Record<string, string> = {
   delegate_to_opencode_cli: 'OpenCode CLI',
   delegate_to_gemini_cli: 'Gemini CLI',
   delegate_to_copilot_cli: 'Copilot CLI',
+  delegate_to_droid_cli: 'Factory Droid',
   delegate_to_cursor_cli: 'Cursor CLI',
   delegate_to_qwen_code_cli: 'Qwen Code CLI',
   whoami_tool: 'Who Am I',
@@ -129,6 +132,7 @@ export const TOOL_DESCRIPTIONS: Record<string, string> = {
   opencode_cli: 'Enable delegation to OpenCode CLI',
   gemini_cli: 'Enable delegation to Gemini CLI',
   copilot_cli: 'Enable delegation to GitHub Copilot CLI',
+  droid_cli: 'Enable delegation to Factory Droid CLI',
   cursor_cli: 'Enable delegation to Cursor Agent CLI',
   qwen_code_cli: 'Enable delegation to Qwen Code CLI',
   spawn_subagent: 'Spawn native subagents with lineage tracking and batch support',
@@ -139,6 +143,7 @@ export const TOOL_DESCRIPTIONS: Record<string, string> = {
   delegate_to_opencode_cli: 'Delegate complex coding tasks to OpenCode CLI',
   delegate_to_gemini_cli: 'Delegate complex coding tasks to Gemini CLI',
   delegate_to_copilot_cli: 'Delegate complex coding tasks to GitHub Copilot CLI',
+  delegate_to_droid_cli: 'Delegate complex coding tasks to Factory Droid CLI',
   delegate_to_cursor_cli: 'Delegate complex coding tasks to Cursor Agent CLI',
   delegate_to_qwen_code_cli: 'Delegate complex coding tasks to Qwen Code CLI',
   whoami_tool: 'Reveal the current agent and chat context',

package/src/components/layout/sidebar-rail.tsx

@@ -17,11 +17,6 @@ import type { AppView } from '@/types'
 const RAIL_EXPANDED_KEY = 'sc_rail_expanded'
 const GITHUB_REPO_URL = 'https://github.com/swarmclawai/swarmclaw'
 const DISCORD_URL = 'https://discord.gg/sbEavS8cPV'
-const NETWORK_LINKS = [
-  { href: 'https://www.swarmdock.ai', label: 'SwarmDock', abbr: 'DO' },
-  { href: 'https://swarmrecall.ai', label: 'SwarmRecall', abbr: 'RE' },
-  { href: 'https://swarmrelay.ai', label: 'SwarmRelay', abbr: 'RL' },
-]
 
 export function SidebarRail({
   onSwitchUser,
@@ -394,48 +389,6 @@ export function SidebarRail({
 
         {/* Bottom: Docs + Daemon + Settings + User */}
         <div className={`flex flex-col gap-1 ${railExpanded ? 'px-3' : 'items-center'}`}>
-          {railExpanded ? (
-            <div className="mb-1">
-              <div className="px-3 pb-1 text-[10px] font-700 uppercase tracking-[0.12em] text-text-3/45">Network</div>
-              <div className="flex flex-col gap-1">
-                {NETWORK_LINKS.map((link) => (
-                  <a
-                    key={link.href}
-                    href={link.href}
-                    target="_blank"
-                    rel="noopener noreferrer"
-                    className="w-full flex items-center gap-2.5 px-3 py-2 rounded-[10px] text-[13px] font-500 cursor-pointer transition-all
-                      bg-transparent text-text-3 hover:text-text hover:bg-white/[0.04] no-underline"
-                    style={{ fontFamily: 'inherit' }}
-                  >
-                    <span className="flex h-5 w-5 shrink-0 items-center justify-center rounded-[6px] border border-white/[0.08] bg-white/[0.03] text-[10px] font-700 uppercase tracking-[0.08em] text-text-3/80">
-                      {link.abbr}
-                    </span>
-                    {link.label}
-                    <svg width="10" height="10" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" className="ml-auto opacity-40">
-                      <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" /><polyline points="15 3 21 3 21 9" /><line x1="10" y1="14" x2="21" y2="3" />
-                    </svg>
-                  </a>
-                ))}
-              </div>
-            </div>
-          ) : (
-            <>
-              <div className="my-1 h-px w-6 bg-white/[0.06]" />
-              {NETWORK_LINKS.map((link) => (
-                <RailTooltip key={link.href} label={link.label} description="Open product site in a new tab">
-                  <a
-                    href={link.href}
-                    target="_blank"
-                    rel="noopener noreferrer"
-                    className="rail-btn text-[10px] font-700 uppercase tracking-[0.08em] no-underline"
-                  >
-                    {link.abbr}
-                  </a>
-                </RailTooltip>
-              ))}
-            </>
-          )}
           {railExpanded ? (
             <a
               href="https://swarmclaw.ai/docs"

package/src/lib/orchestrator-config.ts

@@ -6,6 +6,7 @@ export const NON_ORCHESTRATOR_PROVIDERS = new Set([
   'opencode-cli',
   'gemini-cli',
   'copilot-cli',
+  'droid-cli',
   'cursor-cli',
   'qwen-code-cli',
   'goose',

package/src/lib/provider-sets.ts

@@ -1,11 +1,11 @@
 /** CLI providers that use their own tool execution outside the shared tool-runtime path. */
-export const NON_LANGGRAPH_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'cursor-cli', 'qwen-code-cli'])
+export const NON_LANGGRAPH_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli'])
 
 /** Providers that manage their own runtime/tool loop even when reached over an API endpoint. */
 export const RUNTIME_MANAGED_PROVIDER_IDS = new Set(['hermes', 'goose'])
 
 /** Providers with native tool/capability support (CLI providers + OpenClaw + Hermes). */
-export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'cursor-cli', 'qwen-code-cli', 'goose', 'openclaw', 'hermes'])
+export const NATIVE_CAPABILITY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli', 'goose', 'openclaw', 'hermes'])
 
 /** Providers that can only act as workers — no coordinator role, no heartbeat, no advanced settings. */
-export const WORKER_ONLY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'cursor-cli', 'qwen-code-cli', 'goose', 'openclaw', 'hermes'])
+export const WORKER_ONLY_PROVIDER_IDS = new Set(['claude-cli', 'codex-cli', 'opencode-cli', 'gemini-cli', 'copilot-cli', 'droid-cli', 'cursor-cli', 'qwen-code-cli', 'goose', 'openclaw', 'hermes'])

package/src/lib/providers/cli-utils.test.ts

@@ -94,6 +94,7 @@ describe('isCliProvider', () => {
     assert.equal(isCliProvider('opencode-cli'), true)
     assert.equal(isCliProvider('gemini-cli'), true)
     assert.equal(isCliProvider('copilot-cli'), true)
+    assert.equal(isCliProvider('droid-cli'), true)
     assert.equal(isCliProvider('cursor-cli'), true)
     assert.equal(isCliProvider('qwen-code-cli'), true)
     assert.equal(isCliProvider('goose'), true)
@@ -118,6 +119,7 @@ describe('CLI_PROVIDER_CAPABILITIES', () => {
     assert.ok('opencode-cli' in CLI_PROVIDER_CAPABILITIES)
     assert.ok('gemini-cli' in CLI_PROVIDER_CAPABILITIES)
     assert.ok('copilot-cli' in CLI_PROVIDER_CAPABILITIES)
+    assert.ok('droid-cli' in CLI_PROVIDER_CAPABILITIES)
     assert.ok('cursor-cli' in CLI_PROVIDER_CAPABILITIES)
     assert.ok('qwen-code-cli' in CLI_PROVIDER_CAPABILITIES)
     assert.ok('goose' in CLI_PROVIDER_CAPABILITIES)

package/src/lib/providers/cli-utils.ts

@@ -45,6 +45,13 @@ const KNOWN_BINARY_PATHS: Record<string, string[]> = {
     '/opt/homebrew/bin/copilot',
     path.join(os.homedir(), '.npm-global/bin/copilot'),
   ],
+  droid: [
+    path.join(os.homedir(), '.local/bin/droid'),
+    '/usr/local/bin/droid',
+    '/opt/homebrew/bin/droid',
+    path.join(os.homedir(), '.npm-global/bin/droid'),
+    path.join(os.homedir(), '.factory/bin/droid'),
+  ],
   'cursor-agent': [
     path.join(os.homedir(), '.local/bin/cursor-agent'),
     '/usr/local/bin/cursor-agent',
@@ -166,7 +173,7 @@ export interface AuthProbeResult {
  */
 export function probeCliAuth(
   binary: string,
-  backend: 'claude' | 'codex' | 'opencode' | 'gemini' | 'copilot' | 'cursor' | 'qwen' | 'goose',
+  backend: 'claude' | 'codex' | 'opencode' | 'gemini' | 'copilot' | 'droid' | 'cursor' | 'qwen' | 'goose',
   env: NodeJS.ProcessEnv,
   cwd?: string,
 ): AuthProbeResult {
@@ -277,6 +284,25 @@ export function probeCliAuth(
     return { authenticated: true }
   }
 
+  if (backend === 'droid') {
+    if (process.env.FACTORY_API_KEY || env.FACTORY_API_KEY) {
+      return { authenticated: true }
+    }
+    const configPaths = [
+      path.join(os.homedir(), '.factory', 'config.json'),
+      path.join(os.homedir(), '.config', 'factory', 'config.json'),
+      path.join(os.homedir(), '.factory', 'auth.json'),
+    ]
+    const hasConfig = configPaths.some((p) => fs.existsSync(p))
+    if (!hasConfig) {
+      return {
+        authenticated: false,
+        errorMessage: 'Factory Droid CLI is not authenticated. Run `droid` once to sign in via browser, or set FACTORY_API_KEY and try again.',
+      }
+    }
+    return { authenticated: true }
+  }
+
   if (backend === 'cursor') {
     try {
       const probe = spawnSync(binary, ['status'], {
@@ -427,6 +453,7 @@ export const CLI_PROVIDER_CAPABILITIES: Record<string, string> = {
   'opencode-cli': 'code analysis, generation across multiple LLM backends',
   'gemini-cli': 'code generation, analysis with Gemini models',
   'copilot-cli': 'code generation, analysis, multi-model support via GitHub Copilot',
+  'droid-cli': 'code generation, refactoring, and automation via Factory Droid with configurable autonomy',
   'cursor-cli': 'full-agent coding workflows, multi-file edits, project-aware code changes',
   'qwen-code-cli': 'terminal-native coding workflows, code generation, review, and automation',
   goose: 'agentic coding workflows with extensions, tools, and runtime-managed execution',