release: v2.0.1 — bug-fix release for the ACP hangs + silent errors

Bumps marketplace.json + all six plugin.json to 2.0.1, adds the
v2.0.1 CHANGELOG entry, README badges, and GitHub issue templates.

Behavior changes are entirely in 64ce3c0 / 0e012f7 / 3cd9592 / 63e4a45 /
b94bd2a — this commit packages them as a release.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: greenpolo

.claude-plugin/marketplace.json

@@ -6,49 +6,61 @@
   },
   "metadata": {
     "description": "Marketplace for cc-multi-cli-plugin — delegation to Codex, Gemini, Cursor, and GitHub Copilot CLIs from Claude Code.",
-    "version": "2.0.0"
+    "version": "2.0.1"
   },
   "plugins": [
     {
       "name": "multi",
       "description": "Hub — companion runtime, subagents, setup wizard, customization skills. Install first.",
-      "version": "2.0.0",
-      "author": { "name": "greenpolo" },
+      "version": "2.0.1",
+      "author": {
+        "name": "greenpolo"
+      },
       "source": "./plugins/multi"
     },
     {
       "name": "gemini",
       "description": "Adds /gemini:explore (Gemini 3 Flash, fast code ingestion) and /gemini:research (Gemini 3.1 Pro, deep external research). Requires multi.",
-      "version": "2.0.0",
-      "author": { "name": "greenpolo" },
+      "version": "2.0.1",
+      "author": {
+        "name": "greenpolo"
+      },
       "source": "./plugins/gemini"
     },
     {
       "name": "codex",
       "description": "Adds /codex:execute. Requires multi.",
-      "version": "2.0.0",
-      "author": { "name": "greenpolo" },
+      "version": "2.0.1",
+      "author": {
+        "name": "greenpolo"
+      },
       "source": "./plugins/codex"
     },
     {
       "name": "cursor",
       "description": "Adds /cursor:write, /cursor:plan, /cursor:debug. Requires multi.",
-      "version": "2.0.0",
-      "author": { "name": "greenpolo" },
+      "version": "2.0.1",
+      "author": {
+        "name": "greenpolo"
+      },
       "source": "./plugins/cursor"
     },
     {
       "name": "copilot",
       "description": "Adds /copilot:research, /copilot:review. Requires multi.",
-      "version": "2.0.0",
-      "author": { "name": "greenpolo" },
+      "version": "2.0.1",
+      "author": {
+        "name": "greenpolo"
+      },
       "source": "./plugins/copilot"
     },
     {
       "name": "qwen",
       "description": "Adds /qwen:write (Qwen3-Coder via Qwen Code CLI ACP). Requires multi.",
-      "version": "2.0.0",
-      "author": { "name": "greenpolo" },
+      "version": "2.0.1",
+      "author": {
+        "name": "greenpolo"
+      },
       "source": "./plugins/qwen"
     }
   ]

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,57 @@
+name: Bug report
+description: Something doesn't work — a CLI hangs, errors silently, or behaves wrong.
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to file a bug! A few quick things that make these much faster to triage:
+
+        - **Try `ACP_TRACE=1`** if the issue is silent/stalling. Re-run the failing command with that env var set and paste the stderr — it shows the JSON-RPC traffic between Claude and the CLI and almost always points at the cause.
+        - **Note your CLI version** for whichever CLI is involved (`<cli> --version` or `<cli> about`).
+        - **Check [README › Known issues](../../#known-issues)** for documented upstream bugs already being tracked.
+
+  - type: dropdown
+    id: cli
+    attributes:
+      label: Which CLI is involved?
+      options:
+        - codex
+        - gemini
+        - cursor
+        - copilot
+        - qwen
+        - other / N/A
+    validations:
+      required: true
+
+  - type: input
+    id: cli-version
+    attributes:
+      label: CLI version
+      placeholder: "e.g. 2026.04.17-787b533"
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: What did you run, what did you expect, what did you get?
+      placeholder: |
+        I ran `/cursor:debug investigate the bug in foo.js`.
+        I expected Cursor to read foo.js and propose a fix.
+        Instead the subagent returned "Cursor debugger failed: no output" after 8 minutes.
+    validations:
+      required: true
+
+  - type: textarea
+    id: trace
+    attributes:
+      label: ACP_TRACE output (if applicable)
+      description: Re-run with `ACP_TRACE=1 node ...multi-cli-companion.mjs ... 2>&1` and paste the stderr.
+      render: shell
+
+  - type: input
+    id: os
+    attributes:
+      label: OS
+      placeholder: "Windows 11 / macOS 14 / Ubuntu 24"

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Add a CLI yourself (no issue needed)
+    url: https://github.com/greenpolo/cc-multi-cli-plugin/blob/master/plugins/multi/skills/multi-cli-anything/SKILL.md
+    about: With this plugin installed, ask Claude Code "add <CLI> to cc-multi-cli-plugin" — the multi-cli-anything skill scaffolds everything.
+  - name: Customize an existing CLI/role
+    url: https://github.com/greenpolo/cc-multi-cli-plugin/blob/master/plugins/multi/skills/customize/SKILL.md
+    about: Swap which CLI handles which role, hardcode a model, restrict tools — Claude does the file edits via the customize skill.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,30 @@
+name: Feature request
+description: Add a new CLI, role, or capability to the plugin.
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Adding a new CLI is supported out-of-the-box via the `multi-cli-anything` skill — open Claude Code with this plugin installed and ask: *"add `<cli-name>` to cc-multi-cli-plugin."* Claude scaffolds the new plugin, adapter, subagents, and commands. No issue needed for that path.
+
+        Use this template for: a new built-in CLI (shipped by default), a new role for an existing CLI, a behavior/UX improvement, or anything else.
+
+  - type: textarea
+    id: what
+    attributes:
+      label: What would you like to add or change?
+    validations:
+      required: true
+
+  - type: textarea
+    id: why
+    attributes:
+      label: Why? (concrete use case)
+      description: What task can't you do today that this would unblock?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives you've considered

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## v2.0.1 — 2026-04-26
+
+Bug-fix release. Real-world prompts beyond a one-shot text reply silently broke before this — agents stalled, errors vanished, the forwarding subagents reported success on empty output. This release fixes the entire ACP traffic path.
+
+### Fixed
+
+- **ACP session hangs across all CLIs.** The shared ACP client now responds to incoming JSON-RPC requests from the agent (previously dropped). `buildAutoApproveRequestHandler` services `session/request_permission`, `cursor/ask_question`, and the full `terminal/*` family — without these, agents stalled forever waiting for our response.
+- **Silently-dropped errors.** Non-codex adapter branches now exit 0 on in-protocol errors (with the failure message in rendered output). Previously, exit 1 tripped the forwarding subagent's "if Bash fails, return nothing" rule and the user saw nothing at all.
+- **Cursor `agent acp` Terminal hang.** Plugin now auto-injects a permissive allowlist (`Shell(*)`, `Read/Write/Edit(**)`, `MCP(*)`) into `~/.cursor/cli-config.json` before each Cursor invocation. Without this, Cursor's out-of-band permission gate silently stalls every `execute` tool call.
+- **Gemini `--model auto` hang.** Companion now treats `auto` as "skip `session/set_model`" so the CLI's native alias resolver picks a real model id. Calling `set_model("auto")` over ACP was silently accepted but caused `session/prompt` to hang.
+- **MCP server schema.** `env` is now an array of `{name, value}` per ACP spec (was a `Record<string, string>`).
+
+### Added
+
+- **MCP wiring (Exa + Context7) into ACP `session/new`** for all four ACP adapters (Gemini, Cursor, Copilot, Qwen). Reads keys from `~/.claude/plugins/cc-multi-cli-plugin/config.json` (already populated by `/multi:setup`).
+- **Client-side ACP terminal services** (`scripts/lib/acp-terminals.mjs`) — `terminal/create`, `terminal/output`, `terminal/wait_for_exit`, `terminal/kill`, `terminal/release` backed by `child_process.spawn` with a 1 MiB output ring buffer. Handshake declares `clientCapabilities.terminal: true`.
+- **Yolo / max-permission defaults.** Gemini approval mode is now always `yolo`; Codex sandbox for `--write` tasks is `danger-full-access`; Cursor spawn includes `--yolo --approve-mcps acp` and explicitly sets ACP mode based on role.
+- **`ACP_TRACE=1` env var** for full incoming-message tracing — single most useful diagnostic when an agent silently hangs.
+- **One-time stderr warning** when Cursor 2026.04.17-787b533 (the build with the documented MCP/Terminal regression) is detected. Auto-quiet on other versions.
+- **Operator escape hatches**: `CURSOR_AGENT_PATH` env var is now honored for pinning a specific Cursor build. Documented in the `customize` skill.
+
+### Changed
+
+- **All 10 multi/agents/*.md** loosened forwarding contract: capture stderr (`2>&1`), forbid ad-hoc polling/sleep/cat, return a structured one-line failure summary on Bash failure (instead of silently returning nothing). `--write` defaults added to writer-style agents (cursor-debugger, cursor-writer, qwen-writer).
+- **Skills** (`multi-cli-anything`, `customize`) now document the ACP gotchas we hit empirically — out-of-band permission gates, terminal capability semantics, MCP wiring quirks, mode-setting variance, version sensitivity. `cursor.mjs` is cited as the worked example.
+- **README** Known Issues section with documented Cursor 2026.04.17 upstream regressions (forum links).
+
+### Known issues (upstream, not fixable from the plugin)
+
+- Cursor 2026.04.17 `agent acp` does not send `session/request_permission` over the wire and silently stalls Terminal/MCP tool calls. Workaround: pre-approval via `cli-config.json` allowlist (auto-applied) keeps simple shell exec working; complex multi-tool runs may still hang. Pin an older build via `CURSOR_AGENT_PATH` if needed.
+
 ## v2.0.0 — 2026-04-24
 
 ### Breaking — renamed from `skill-gemini` to `cc-multi-cli-plugin`

README.md

@@ -2,6 +2,12 @@
 
 # cc-multi-cli-plugin
 
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
+[![Latest release](https://img.shields.io/github/v/release/greenpolo/cc-multi-cli-plugin?include_prereleases&sort=semver&label=release)](https://github.com/greenpolo/cc-multi-cli-plugin/releases)
+[![Built for Claude Code](https://img.shields.io/badge/built_for-Claude_Code-d97757)](https://docs.anthropic.com/en/docs/claude-code)
+[![CLIs supported](https://img.shields.io/badge/CLIs-Codex_·_Gemini_·_Cursor_·_Copilot_·_Qwen-555)](#commands)
+[![Stars](https://img.shields.io/github/stars/greenpolo/cc-multi-cli-plugin?style=social)](https://github.com/greenpolo/cc-multi-cli-plugin/stargazers)
+
 If you have access to multiple AI coding CLIs (Codex, Gemini, Cursor, Copilot, etc.), this plugin lets Claude Code delegate to whichever one is best for the task — without you having to switch tools or run them yourself.
 
 Each CLI is wired up through its native protocol (ACP, ASP, JSON-RPC). This allows you to pick and choose all the best features from each CLIs; like /debug mode from Cursor, /research from Copilot, etc... Sessions, streaming, tool calls, and background jobs all work normally.

plugins/codex/.claude-plugin/plugin.json

@@ -1,11 +1,16 @@
 {
   "name": "codex",
   "description": "Delegate plan execution to Codex CLI via ASP. Part of cc-multi-cli-plugin. Requires the `multi` plugin.",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "author": {
     "name": "greenpolo",
     "url": "https://github.com/greenpolo"
   },
   "license": "Apache-2.0",
-  "keywords": ["claude-code", "codex", "execute", "asp"]
+  "keywords": [
+    "claude-code",
+    "codex",
+    "execute",
+    "asp"
+  ]
 }

plugins/copilot/.claude-plugin/plugin.json

@@ -1,11 +1,17 @@
 {
   "name": "copilot",
   "description": "Delegate GitHub-context research and code review to GitHub Copilot CLI via ACP. Part of cc-multi-cli-plugin. Requires the `multi` plugin.",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "author": {
     "name": "greenpolo",
     "url": "https://github.com/greenpolo"
   },
   "license": "Apache-2.0",
-  "keywords": ["claude-code", "copilot", "research", "review", "acp"]
+  "keywords": [
+    "claude-code",
+    "copilot",
+    "research",
+    "review",
+    "acp"
+  ]
 }

plugins/cursor/.claude-plugin/plugin.json

@@ -1,11 +1,17 @@
 {
   "name": "cursor",
   "description": "Delegate coding, planning, and debugging to Cursor CLI via ACP. Part of cc-multi-cli-plugin. Requires the `multi` plugin.",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "author": {
     "name": "greenpolo",
     "url": "https://github.com/greenpolo"
   },
   "license": "Apache-2.0",
-  "keywords": ["claude-code", "cursor", "write", "debug", "acp"]
+  "keywords": [
+    "claude-code",
+    "cursor",
+    "write",
+    "debug",
+    "acp"
+  ]
 }

plugins/gemini/.claude-plugin/plugin.json

@@ -1,11 +1,16 @@
 {
   "name": "gemini",
   "description": "Delegate research to Gemini CLI via ACP. Part of cc-multi-cli-plugin. Requires the `multi` plugin.",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "author": {
     "name": "greenpolo",
     "url": "https://github.com/greenpolo"
   },
   "license": "Apache-2.0",
-  "keywords": ["claude-code", "gemini", "research", "acp"]
+  "keywords": [
+    "claude-code",
+    "gemini",
+    "research",
+    "acp"
+  ]
 }