crewswarm 0.8.1-beta

package/engines/codex.json

@@ -0,0 +1,37 @@
+{
+  "id": "codex",
+  "label": "Codex CLI",
+  "description": "OpenAI Codex CLI — non-interactive agentic coding with danger-full-access sandbox and no approval prompts. Works with OpenAI models out of the box.",
+  "shouldUse": {
+    "runtime": ["codex", "codex-cli"],
+    "payloadKey": "useCodex",
+    "agentConfigKey": "useCodex",
+    "envVar": "CREWSWARM_CODEX"
+  },
+  "bin": "codex",
+  "installCmd": "npm install -g @openai/codex",
+  "installUrl": "https://github.com/openai/codex",
+  "docsUrl": "https://github.com/openai/codex#readme",
+  "color": "#a78bfa",
+  "icon": "codex",
+  "agentConfigKey": "useCodex",
+  "envToggle": "CREWSWARM_CODEX",
+  "authNote": "Uses OAuth — run `codex login` once to authenticate. No API key needed.",
+  "bestFor": ["crew-coder", "crew-coder-back", "crew-coder-front", "crew-fixer"],
+  "traits": [
+    "danger-full-access sandbox — full machine access, no approval prompts",
+    "Non-interactive exec mode (codex exec --json)",
+    "OpenAI models — works with your existing OPENAI_API_KEY",
+    "MCP-connected: agents available inside Codex sessions"
+  ],
+  "args": {
+    "run": ["-a", "never", "exec", "--sandbox", "danger-full-access", "--json", "{prompt}"]
+  },
+  "outputMode": "json-stream",
+  "jsonOutputEvent": "item.completed",
+  "jsonOutputField": "item.text",
+  "mcpSetup": {
+    "command": "codex mcp add crewswarm --url \"http://127.0.0.1:5020/mcp\" --bearer-token-env-var CREWSWARM_TOKEN",
+    "envRequired": "CREWSWARM_TOKEN"
+  }
+}

package/engines/crew-cli.json

@@ -0,0 +1,42 @@
+{
+  "id": "crew-cli",
+  "label": "crew-cli",
+  "description": "crewswarm's native CLI with intelligent routing, sandbox workflow, and cross-repo context. Full agent orchestration with safety gates, review loops, and persistent memory.",
+  "_note": "crew-cli command integration updated (uses 'crew chat' as of March 2026)",
+  "shouldUse": {
+    "runtime": ["crew-cli", "crewcli"],
+    "payloadKey": "useCrewCLI",
+    "agentConfigKey": "useCrewCLI",
+    "envVar": "CREWSWARM_CREW_CLI_ENABLED"
+  },
+  "bin": "crew",
+  "binAlternate": "~/CrewSwarm/crew-cli/bin/crew.js",
+  "installCmd": "cd ~/CrewSwarm/crew-cli && npm install && npm run build",
+  "installUrl": "https://github.com/crewswarm/crewswarm/tree/main/crew-cli",
+  "docsUrl": "https://github.com/crewswarm/crewswarm/blob/main/crew-cli/docs/OVERVIEW.md",
+  "color": "#8b5cf6",
+  "icon": "crew",
+  "agentConfigKey": "useCrewCLI",
+  "envToggle": "CREWSWARM_CREW_CLI_ENABLED",
+  "bestFor": ["crew-coder", "crew-coder-front", "crew-coder-back", "crew-fixer"],
+  "traits": [
+    "Intelligent routing to 20+ specialist agents",
+    "Sandbox workflow (preview → branch → apply)",
+    "Cross-repo context injection",
+    "QA loop with fixer integration",
+    "Git-aware context (diffs, branches, status)",
+    "Persistent memory via AgentKeeper",
+    "Cost-optimized 3-tier LLM architecture",
+    "Safety gates (--check flag, blast radius)"
+  ],
+  "args": {
+    "chat": ["chat", "{prompt}"],
+    "plan": ["plan", "{prompt}"],
+    "run": ["run", "-t", "{prompt}"],
+    "dispatch": ["dispatch", "{agent}", "{prompt}"]
+  },
+  "outputMode": "streaming",
+  "requiresEnv": [],
+  "requiresAuth": false,
+  "notes": "crew-cli is crewswarm's native execution engine. Unlike external CLIs (OpenCode, Cursor), it has direct access to the full agent roster, shared memory, and gateway routing. Use for complex multi-agent tasks, planning, and orchestration."
+}

package/engines/cursor.json

@@ -0,0 +1,40 @@
+{
+  "id": "cursor",
+  "label": "Cursor CLI",
+  "description": "Route agent tasks through Cursor's native subagent system. Parallel waves, isolated context windows per agent, no queuing. Best for complex reasoning and architectural work.",
+  "shouldUse": {
+    "runtime": ["cursor", "cursor-cli"],
+    "payloadKey": "useCursorCli",
+    "agentConfigKey": "useCursorCli",
+    "envVar": "CREWSWARM_CURSOR_ENABLED",
+    "specialLogic": "orchestrator-waves"
+  },
+  "bin": "cursor",
+  "binAlternate": "~/.local/bin/agent",
+  "installCmd": "# Install Cursor from https://cursor.sh then enable CLI from Command Palette → Install cursor command",
+  "installUrl": "https://cursor.sh",
+  "docsUrl": "https://docs.cursor.com/advanced/cli",
+  "color": "#818cf8",
+  "icon": "cursor",
+  "agentConfigKey": "useCursorCli",
+  "envToggle": "CREWSWARM_CURSOR_ENABLED",
+  "authNote": "Uses your Cursor IDE login — no separate API key needed.",
+  "modelEnvVar": "CREWSWARM_CURSOR_MODEL",
+  "modelKey": "cursorModel",
+  "defaultModel": "composer-2-fast",
+  "bestFor": ["crew-main", "crew-architect", "crew-orchestrator"],
+  "traits": [
+    "Parallel waves via crew-orchestrator subagent",
+    "Isolated context windows — no cross-agent bleed",
+    "Default CLI model: composer-2-fast (Composer 2); override with cursorCliModel or CREWSWARM_CURSOR_MODEL",
+    "Also supports Cursor CLI ids: composer-2, sonnet-4.5, gpt-5.2, gemini-3-flash, etc. (see agent --list-models)",
+    "Requires Cursor IDE installed + agent CLI login"
+  ],
+  "args": {
+    "run": ["agent", "--print", "--yolo", "--output-format", "stream-json", "{prompt}"],
+    "run_with_model": ["agent", "--print", "--yolo", "--output-format", "stream-json", "--model", "{model}", "{prompt}"]
+  },
+  "outputMode": "streaming",
+  "timeoutMs": 300000,
+  "timeoutEnv": "CREWSWARM_CURSOR_TIMEOUT_MS"
+}

package/engines/docker-sandbox.json

@@ -0,0 +1,38 @@
+{
+  "id": "docker-sandbox",
+  "label": "Docker Sandbox",
+  "description": "Run any crewswarm engine inside an isolated Docker microVM. Filesystem and network are sandboxed — API keys are injected by the network proxy and never exposed to the agent.",
+  "shouldUse": {
+    "runtime": ["docker-sandbox", "docker"],
+    "payloadKey": "useDockerSandbox",
+    "agentConfigKey": "useDockerSandbox",
+    "envVar": "CREWSWARM_DOCKER_SANDBOX"
+  },
+  "bin": "docker",
+  "installCmd": "brew install --cask docker",
+  "installUrl": "https://www.docker.com/products/docker-desktop/",
+  "docsUrl": "https://www.docker.com/blog/run-openclaw-securely-in-docker-sandboxes/",
+  "color": "#2496ed",
+  "icon": "docker-sandbox",
+  "agentConfigKey": "useDockerSandbox",
+  "envToggle": "CREWSWARM_DOCKER_SANDBOX",
+  "authNote": "Requires Docker Desktop with Sandboxes enabled. Set CREWSWARM_DOCKER_SANDBOX_NAME to your sandbox name (default: crewswarm). Create once with: docker sandbox create --name crewswarm shell <workspace>",
+  "bestFor": ["crew-coder", "crew-coder-back", "crew-coder-front", "crew-fixer", "crew-security"],
+  "traits": [
+    "Isolated microVM — agent cannot touch host filesystem outside workspace",
+    "Network proxy injects API keys — keys never exposed inside sandbox",
+    "Wraps any inner engine: Claude Code, OpenCode, Cursor CLI, or Codex",
+    "Inner engine configurable via CREWSWARM_DOCKER_SANDBOX_INNER_ENGINE"
+  ],
+  "requiresEnv": [],
+  "setupSteps": [
+    "Enable Docker Sandboxes in Docker Desktop → Settings → Sandboxes",
+    "Create a sandbox: docker sandbox create --name crewswarm shell <your-project-dir>",
+    "Allow localhost access: docker sandbox network proxy crewswarm --allow-host localhost",
+    "Set CREWSWARM_DOCKER_SANDBOX_NAME=crewswarm in dashboard → Security → Env Vars"
+  ],
+  "args": {
+    "run": ["sandbox", "exec", "{sandboxName}", "--", "{innerEngine}", "{prompt}"]
+  },
+  "outputMode": "streaming"
+}

package/engines/gemini-cli.json

@@ -0,0 +1,75 @@
+{
+  "id": "gemini-cli",
+  "label": "Gemini CLI",
+  "description": "Google's open-source terminal AI agent powered by Gemini 3. Free tier: 60 req/min and 1,000 req/day with a personal Google account. Runs non-interactively with -p flag. Full workspace context, built-in Google Search grounding, file operations, and shell commands.",
+  "shouldUse": {
+    "runtime": ["gemini", "gemini-cli"],
+    "payloadKey": "useGeminiCli",
+    "agentConfigKey": "useGeminiCli",
+    "envVar": "CREWSWARM_GEMINI_CLI_ENABLED"
+  },
+  "bin": "gemini",
+  "installCmd": "npm install -g @google/gemini-cli",
+  "installUrl": "https://github.com/google-gemini/gemini-cli",
+  "docsUrl": "https://geminicli.com/docs/",
+  "color": "#4285f4",
+  "icon": "gemini",
+  "agentConfigKey": "useGeminiCli",
+  "envToggle": "CREWSWARM_GEMINI_CLI_ENABLED",
+  "authNote": "No API key needed for free tier. Three auth options below — pick one.",
+  "requiresAuth": true,
+  "authMethods": [
+    {
+      "label": "Option 1 — Google OAuth (free, recommended)",
+      "cmd": "gemini auth login",
+      "note": "Opens your browser. Free quota: 60 req/min · 1,000 req/day with any personal Google account."
+    },
+    {
+      "label": "Option 2 — Gemini API key",
+      "cmd": "export GEMINI_API_KEY=your_key_here",
+      "note": "Get a key at aistudio.google.com/apikey — paste it in your shell profile or set it in Dashboard → Providers."
+    },
+    {
+      "label": "Option 3 — Vertex AI (enterprise / GCP)",
+      "cmd": "export GOOGLE_CLOUD_PROJECT=your_project_id && gcloud auth application-default login",
+      "note": "For Google Cloud users — uses your GCP project quota."
+    }
+  ],
+  "modelEnvVar": "CREWSWARM_GEMINI_CLI_MODEL",
+  "modelFlag": "-m",
+  "bestFor": ["crew-coder", "crew-researcher", "crew-main"],
+  "traits": [
+    "Free tier: 60 req/min and 1,000 req/day with personal Google account",
+    "Gemini 3 models with 1M token context window",
+    "Built-in Google Search grounding for real-time info",
+    "Non-interactive headless mode: gemini -p \"task\" --output-format stream-json",
+    "Open source Apache 2.0 — 95k+ GitHub stars"
+  ],
+  "defaultModel": "gemini-2.5-pro",
+  "modelSuggestions": [
+    "gemini-2.5-pro",
+    "gemini-2.5-flash",
+    "gemini-3-pro-preview",
+    "gemini-3-flash-preview"
+  ],
+  "args": {
+    "run": ["-p", "{prompt}", "--output-format", "stream-json"],
+    "run_with_model": ["-p", "{prompt}", "-m", "{model}", "--output-format", "stream-json"],
+    "run_yolo": ["-p", "{prompt}", "--output-format", "stream-json", "--yolo"]
+  },
+  "outputMode": "stream-json",
+  "streamJsonEvents": {
+    "init":        { "eventType": "init",        "fields": ["session_id", "model", "timestamp"] },
+    "text_chunk":  { "eventType": "message",     "path": "content", "filter": "role === 'assistant' && delta === true" },
+    "tool_use":    { "eventType": "tool_use",    "fields": ["tool_name", "tool_id", "parameters"] },
+    "tool_result": { "eventType": "tool_result", "fields": ["tool_id", "status", "output", "error"] },
+    "done":        { "eventType": "result",      "fields": ["status", "stats"] },
+    "error":       { "eventType": "error",       "fields": ["severity", "message"] }
+  },
+  "exitCodes": {
+    "0":  "Success",
+    "1":  "General error or API failure",
+    "42": "Input error (invalid prompt or arguments)",
+    "53": "Turn limit exceeded"
+  }
+}

package/engines/opencode.json

@@ -0,0 +1,31 @@
+{
+  "id": "opencode",
+  "label": "OpenCode",
+  "description": "Full agentic coding sessions with persistent memory, file editing, and bash execution. Runs opencode run — the original crewswarm execution engine.",
+  "shouldUse": {
+    "runtime": ["opencode", "gpt5", "gpt-5"],
+    "payloadKey": "useOpenCode",
+    "agentConfigKey": "useOpenCode",
+    "envVar": "CREWSWARM_OPENCODE_ENABLED"
+  },
+  "bin": "opencode",
+  "installCmd": "npm install -g opencode-ai",
+  "installUrl": "https://opencode.ai",
+  "docsUrl": "https://opencode.ai/docs",
+  "color": "#38bdf8",
+  "icon": "opencode",
+  "agentConfigKey": "useOpenCode",
+  "envToggle": "CREWSWARM_OPENCODE_ENABLED",
+  "bestFor": ["crew-coder", "crew-coder-back", "crew-coder-front", "crew-fixer"],
+  "traits": [
+    "Persistent sessions — context survives between tasks",
+    "Full file editing with native tool use",
+    "Bash execution with approval gate",
+    "Works with any model/provider"
+  ],
+  "args": {
+    "run": ["run", "{prompt}", "--model", "{model}"],
+    "continue": ["run", "{prompt}", "--continue", "--model", "{model}"]
+  },
+  "outputMode": "streaming"
+}