Repository navigation
v0.1.1
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 --versionRegister it with Claude Code:
claude mcp add --transport stdio --scope user codex-discussion -- codex-discussion-mcpSee 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_listreads 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_startanddiscussion_replyaccept 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_readpolls for public messages and progress with bounded waits and scoped pagination cursors. - Explicit outcomes: turns finish as
completed,failed,interruptedorconnectionLost. Inference is never replayed automatically after a timeout or connection loss. - Cancel and resume:
discussion_cancelinterrupts 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