Codex-Co-Engineer 3.1.1

Codex-Co-Engineer 3.1.1

Repository-side GitHub Release body for Codex-Co-Engineer 3.1.1.

What changed

3.1.1 fixes an ambiguity in the delegation instructions. The MCP tool has
always required the absolute Git worktree path in the property named repo,
but the 3.1.0 control skill described that value only as an "absolute Git
root." A caller could reasonably translate that prose into git_root, which
the strict schema rejects before a task receipt exists.

The public contract now shows the literal argument everywhere it matters:

{
  "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
}

Use the property name repo exactly. git_root, repository, and other
aliases are not accepted.

Cursor Cloud also requires repo, identifying the clean local checkout whose
provider-accessible origin is used. Its already-pushed immutable commit SHA is
a separate, Cursor Cloud-only starting_ref property:

{
  "task_id": "cloud-auth-refactor",
  "provider": "cursor-cloud",
  "repo": "/absolute/path/to/clean-checkout",
  "starting_ref": "0123456789abcdef0123456789abcdef01234567",
  "role": "implement",
  "prompt": "Implement the requested change, run tests, and commit the result.",
  "expected_duration_ms": 3600000,
  "create_pr": true
}

Regression coverage now pins this language in the control skill and MCP tool
schema so the call-shape mismatch cannot recur.

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.

See CHANGELOG.md for the complete change history and the
README for provider setup, safety boundaries, and usage.

This file is the publication source for the GitHub Release. Publishing it is a
separate explicit action:

gh release create v3.1.1 --title "Codex-Co-Engineer 3.1.1" --notes-file docs/releases/v3.1.1.md