Skip to content

v0.1.1

Choose a tag to compare

@smallmiro smallmiro released this 25 Oct 11:28
· 30 commits to main since this release

This is the first GitHub Release of @mirolab/codex-discussion-mcp, a local stdio MCP server that lets coding agents discuss questions with Codex through codex app-server. The calling agent controls the discussion and chooses the model and reasoning effort for every turn.

0.1.1 contains no runtime behavior changes from 0.1.0. It republishes the package with English user documentation.

Install

Requires Node.js 22.14 or newer and an installed, authenticated Codex CLI.

npm install -g @mirolab/codex-discussion-mcp@0.1.1
codex-discussion-mcp --version

Register it with Claude Code:

claude mcp add --transport stdio --scope user codex-discussion -- codex-discussion-mcp

See the README for Antigravity CLI, Kiro CLI and other MCP hosts.

Highlights

These features shipped in 0.1.0 and are carried forward unchanged:

  • Dynamic model discovery: models_list reads the Codex model catalog and each model's supported reasoning efforts. Selections are validated against the catalog and another model is never substituted silently.
  • Per-turn model and effort: discussion_start and discussion_reply accept a model and effort for each turn. Changing the model without an effort selects the new model's default effort.
  • Asynchronous discussions: start and reply return immediately. discussion_read polls for public messages and progress with bounded waits and scoped pagination cursors.
  • Explicit outcomes: turns finish as completed, failed, interrupted or connectionLost. Inference is never replayed automatically after a timeout or connection loss.
  • Cancel and resume: discussion_cancel interrupts a specific turn, and persisted discussions can be read and continued after reconnecting.
  • Read-only and isolated: discussions run read-only, reuse the existing Codex login and provider configuration without reading credential files, and disable inherited MCP connections, apps and plugins. Reasoning items are never exposed.

Changes since 0.1.0

  • Translated the README and the shipped publishing guide (docs/publishing.md) to English.
  • Translated the design, verification and release records to English.
  • Added AGENTS.md, a contributor guide covering the repository map, commands, behavioral contracts and release rules.
  • Switched the live smoke test (npm run smoke) to English prompts.

Verification

Type checking, 48 tests, the build and packed-tarball installation verification (executable, MCP discovery, model selection and a two-turn discussion) passed on GitHub Actions, and that same tarball was published. The public npm tarball and the GitHub artifact have the same SHA-512, and a fresh install by name reports 0.1.1.

sha512-Tm58rb5HM+eN5VyBeIEXTOzb3uLymbl1wUyW1n9DH5zgFyQZz9nOM5FNUa+ZddveW6et3fldWCetpN3cYk0Vng==

This version was published with the bootstrap token workflow (run) because the npm Trusted Publisher for OIDC publishing is not configured yet. See the release record.

Full changelog: aa93894...v0.1.1