Skip to content

v1.6.3 — Reliable Codex MCP Support on Windows

Choose a tag to compare

View all tags
@Lotargo Lotargo released this 13 Aug 03:48
· 127 commits to main since this release
v.1.6.3
0957262

Release title

v1.6.3 — Reliable Codex MCP Support on Windows

Release notes

Highlights

This release fixes memory-agent startup and tool exposure in Codex on Windows.

Codex no longer launches the MCP server through npx or Windows .cmd shims. Instead, setup now configures a direct and reliable process chain:

Codex → node.exe → mcp-server/boot.js

Fixed

  • Replaced the Codex npx launcher with absolute paths to Node.js and boot.js.
  • Added validation for Node.js 22.5.0 or newer before writing Codex configuration.
  • Added safe migration of legacy [mcp_servers.memory-agent] sections.
  • Legacy opencode-memory-plugin and @lotargo/memory_plugin entries are migrated automatically.
  • Preserved unrelated settings in ~/.codex/config.toml.
  • Prevented duplicate MCP sections during repeated setup.
  • Improved global prompt idempotency and duplicate-block cleanup while preserving user-authored AGENTS.md and CLAUDE.md content.

New Codex diagnostics

Added:

memory_plugin doctor --codex

The command verifies:

  • Codex configuration and MCP registration
  • Direct Node.js executable
  • Node.js version compatibility
  • Packaged boot.js entry point
  • MCP initialize
  • tools/list
  • Live memory_info call
  • Live recall(scope="all") call
  • Current Git project identity
  • Codex memory prompt installation

It also helps distinguish plugin startup failures from Codex Desktop tool-exposure issues.

Documentation

Corrected and clarified the available tool counts:

  • 15 MCP server tools
  • 16 native OpenCode plugin tools
  • 17 unique tool names across both integrations

The README now explicitly lists the OpenCode tools and documents which tools are integration-specific.

Testing

Added regression coverage for:

  • Windows paths containing spaces
  • TOML escaping and section-aware migration
  • Legacy and duplicate Codex configurations
  • Direct MCP initialize, tool discovery, and tool calls
  • Project isolation across multiple Git repositories
  • Global-only memory outside Git repositories
  • Prompt installation and removal idempotency

All unit, integration, Codex MCP, and cloud test suites pass.

Upgrade

npm install -g @lotargo/memory_plugin@1.6.3
memory_plugin setup --codex
memory_plugin doctor --codex

Restart Codex Desktop and open a new task after upgrading so the refreshed MCP tool list is loaded.

Assets 2
Loading