Codex-Co-Engineer 3.2.0

Codex-Co-Engineer 3.2.0

Repository-side GitHub Release body for Codex-Co-Engineer 3.2.0.
This file is the publication source. It does not create a GitHub Release,
tag, or remote by itself.

Date: 2026-08-20
Package / plugin / MCP id: codex-co-engineer
Skill: control-codex-co-engineer-agents
Tools: status, delegate, task, tasks, cancel

What changed

3.2.0 keeps the thin five-tool catalog and makes parallel coordination cheaper
without changing the 3.1.1 default omitted-mode response shapes.

Measured efficiency

Compact readiness and list paths avoid constructing full receipts for omitted
rows. With full JSON-RPC text duplication, measured sizes stay within:

• readiness-only status ≤ 8,192 bytes
• compact status with 20 cards ≤ 24,576 bytes
• compact tasks page with 20 cards ≤ 32,768 bytes

The single-task view: "compact" structured payload is capped at 8,192 UTF-8
bytes by the MCP server. That is a server guarantee, not a measured Codex
Desktop renderer hard limit.

Compact task and list pagination

• status: detail: "compact", task_limit 0–20, or include_tasks: false
  for readiness-only checks.
• task: view: "compact" for routine progress; keep
  view: "diagnostics" for attention and failure evidence.
• tasks: detail: "compact", limit 1–20, and opaque keyset next_cursor
  with provider/state filters bound into the cursor.

Compact status/task cards preserve the complete valid task ID. Pass that ID
unchanged to task, cancel, or wait-any; the card's normalized state and
updated_at carry the routine lifecycle signal without duplicating raw status
or terminal timestamp fields.

Opt-in structured transport

Clients that consume structuredContent may set
response_mode: "structured" on any of the five tools. Text becomes a bounded
fallback; structuredContent remains authoritative. Omitting the property
preserves the exact 3.1.1-compatible full JSON text duplication. The
efficiency harness records at least 30% aggregate JSON-RPC reduction versus
the immutable 3.1.1 duplication baseline when structured mode is opted in.

Bounded, redacted terminal evidence

Terminal provider results are redacted and bounded, including nested objects.
When evidence is clipped, receipts report result_truncated and, when the
source size is known, result_original_chars (Unicode code points).

Managed workspace and Cursor Cloud preflight

Managed local tasks verify worktree identity before provider launch. Cursor
Cloud preflight hardens provider-visible origin checks and fails closed on
credential-bearing or unsupported origins. Cloud still requires the local
checkout in repo and a pushed immutable commit SHA in starting_ref.

Wait-any semantics

Coordinate 1–8 exact tasks through one tasks call:

{
  "task_ids": [
    "change-api-validation",
    "update-operator-guide"
  ],
  "wait_until": "terminal",
  "wait_ms": 3600000
}

Supply per-task event cursors when continuing a wait. Wait-any options cannot
be mixed with list filters or pagination. Each target snapshot and live event
preview is bounded; when a preview is present, progress.detail_hint directs
the caller to task for that target's full live event detail. Aggregate
structured wait-any responses stay within a 72 KiB cap. Disconnecting the
waiter does not cancel provider work.

Install

Requires Node.js 24+, Git, Codex CLI, and worktree-bootstrap for managed
local tasks.

git clone https://github.com/ajhcs/Codex-Co-Engineer.git
cd Codex-Co-Engineer
codex plugin marketplace add "$PWD"
codex plugin add codex-co-engineer@codex-co-engineer
npm --prefix plugins/codex-co-engineer run setup
npm --prefix plugins/codex-co-engineer run setup:check

Start a new Codex session after installing or upgrading the plugin.

The repository argument remains the literal MCP property repo:

{
  "task_id": "review-auth-refactor",
  "provider": "grok",
  "repo": "/absolute/path/to/git-worktree",
  "role": "review",
  "workspace_mode": "managed",
  "prompt": "Review the current branch and report concrete correctness risks.",
  "expected_duration_ms": 600000
}

See CHANGELOG.md for the complete change history, the
efficient dogfood workflow for coordination
examples, and the README for provider setup and safety
boundaries.

This file is the publication source for the GitHub Release. Publishing it is a
separate explicit action against an exact reviewed main SHA. Capture the
exact-tree gate receipt first (not run by documentation-only work):

release-gate run --repo "$PWD" \
  --receipt /tmp/codex-co-engineer-v3.2.0-release-gate.json

Suggested later publication command, with the reviewed SHA substituted for the
placeholder (not run by this change):

gh release create v3.2.0 \
  --title "Codex-Co-Engineer 3.2.0" \
  --notes-file docs/releases/v3.2.0.md \
  --target EXACT_REVIEWED_MAIN_SHA