Codex Father v5.0.0

Codex Father v5.0.0

🎯 Version Information

• Version: 5.0.0
• Release Date: $(date +%Y-%m-%d)
• Main Package: codex-father
• MCP Package: @starkdev020/codex-father-mcp-server

📦 Installation

Main Project - Global Install

npm install -g codex-father@5.0.0

Main Project - npx Usage (No Install Required)

# Main CLI
npx codex-father@5.0.0 --help

# Start script with full features
npx codex-father-start@5.0.0 --task "Create a feature"

# Job script
npx codex-father-job@5.0.0 --help

MCP Server - Global Install

npm install -g @starkdev020/codex-father-mcp-server@5.0.0

MCP Server - npx Usage (Recommended)

npx @starkdev020/codex-father-mcp-server@5.0.0 --help

📚 Documentation

• GitHub Repository
• Documentation
• CHANGELOG

🔗 Links

• Main NPM Package
• MCP NPM Package
• Release Notes

mcp-v3.2.0

3.2.0 (2025-10-13)

Features

• Add codex.version tool that returns both human text and structured fields
  (mcpName/mcpVersion/coreName/coreVersion/node/platform/pid), enabling
  automated environment inspection by MCP clients.

Docs

• Update README (en/zh) and user manuals to document version query via
  CLI/MCP/HTTP; add examples for GET /api/v1/version and GET /healthz.

Tests

• Ensure tools spec includes codex.version.
• Basic handler smoke covered by project tests.

See also: CHANGELOG

mcp-v3.1.1

3.1.1 (2025-10-12)

Fixes

• runtime/common: 忽略“未使用的 MCP 客户端启动超时”（如 MCP client for \\context7\ failed to start: request timed out），避免误将整次运行判为
  network_error；如需保留旧行为，可设置 CODEX_IGNORE_MCP_START_FAILURES=0。
• runtime/common: 统一在每轮执行后补齐 last.txt 末尾换行，减少解析噪音；
  将 CONTROL: DONE/CONTINUE 的识别改为“整行匹配”，避免句中提及误判。

Chore

• assets: 同步更新 assets/runtime/lib/common.sh 与主库逻辑，保持运行时行为一致。

See also: CHANGELOG

mcp-v3.1.0

3.1.0 (2025-10-12)

Features

• diagnostics/bridge-layer:
  list-sessions、get-latest-session、read-session-artifacts
  现默认遵循会话根目录环境变量：优先 CODEX_SESSIONS_ROOT（兼容
  CODEX_SESSIONS_HOME），未设置时回退至
  .codex-father/sessions。统一路径解析以便与 CLI、Shell 运行器一致。

Docs

• User Manual（中/英）补充“日志摘要（v1.7 新增）/Log Summary”与多会话统计示例；
• 解释如何通过 CODEX_ECHO_INSTRUCTIONS 与 CODEX_ECHO_INSTRUCTIONS_LIMIT
  控制合成指令全文回显；
• README（中/英）与 Troubleshooting 文档加入 scripts/validate-session.sh
  的健康检查示例；
• 明确推荐通过 CODEX_SESSIONS_ROOT 配置新根目录，历史
  .codex-father-sessions/ 可用软链兼容。

Notes

• 本次改动不改变 MCP 工具的入参与返回契约，属于可观测性与路径一致性的改进；
• 建议客户端在“会话浏览”场景下使用 list-sessions 与 get-latest-session
  并尊重服务器返回的 sessionRoot 字段。

See also: CHANGELOG

mcp-v3.0.1

3.0.1 (2025-10-12)

Docs

• 统一文档配置口径：prod（生产）统一使用
  npx @starkdev020/codex-father-mcp-server --transport=ndjson；preview（本地调试）使用本地源码
  node .../dist/index.js --transport=ndjson。更新了中英文的 README、Installation、Configuration、Manual、Quick
  Start。

Notes

• 仅文档与示例更新，不涉及运行时代码行为变更。

See also: CHANGELOG

mcp-v3.0.0

[3.0.0]

Features

• runtime: 补丁模式默认将 diff 落盘并在日志中仅输出预览，支持新的
  --patch-output/--patch-preview-lines/--no-patch-preview/
  --no-patch-artifact CLI 透传，元数据包含补丁哈希与行数。

Docs

• help: codex.help 增加补丁控量、日志降噪（--no-echo-instructions、
  --no-carry-context、view=result-only 等）提示。

Fixes

• runtime: 可写沙箱 + never 组合默认改为归一到
  on-failure，避免无人值守健康检查被判定 approval_required；需要保留 never
  时可设置 ALLOW_NEVER_WITH_WRITABLE_SANDBOX=1。
• exec/runtime: runId
  目录名时间戳改为使用系统本地时区（exec-YYYYMMDDHHmmss-<tag>），并在 CLI 展示时附带本地偏移而非固定
  Z。

Notes auto-generated from Unreleased due to missing explicit entry for 3.0.0.

See also: CHANGELOG

mcp-v2.2.0

[2.2.0]

Features

• runtime: 补丁模式默认将 diff 落盘并在日志中仅输出预览，支持新的
  --patch-output/--patch-preview-lines/--no-patch-preview/
  --no-patch-artifact CLI 透传，元数据包含补丁哈希与行数。

Docs

• help: codex.help 增加补丁控量、日志降噪（--no-echo-instructions、
  --no-carry-context、view=result-only 等）提示。

Fixes

• runtime: 可写沙箱 + never 组合默认改为归一到
  on-failure，避免无人值守健康检查被判定 approval_required；需要保留 never
  时可设置 ALLOW_NEVER_WITH_WRITABLE_SANDBOX=1。
• exec/runtime: runId
  目录名时间戳改为使用系统本地时区（exec-YYYYMMDDHHmmss-<tag>），并在 CLI 展示时附带本地偏移而非固定
  Z。

Notes auto-generated from Unreleased due to missing explicit entry for 2.2.0.

See also: CHANGELOG

mcp-v2.1.0

[2.1.0]

Features

• runtime: 补丁模式默认将 diff 落盘并在日志中仅输出预览，支持新的
  --patch-output/--patch-preview-lines/--no-patch-preview/
  --no-patch-artifact CLI 透传，元数据包含补丁哈希与行数。

Docs

• help: codex.help 增加补丁控量、日志降噪（--no-echo-instructions、
  --no-carry-context、view=result-only 等）提示。

Fixes

• runtime: 可写沙箱 + never 组合默认改为归一到
  on-failure，避免无人值守健康检查被判定 approval_required；需要保留 never
  时可设置 ALLOW_NEVER_WITH_WRITABLE_SANDBOX=1。

Notes auto-generated from Unreleased due to missing explicit entry for 2.1.0.

See also: CHANGELOG

mcp-v2.0.0

2.0.0 (2025-10-08)

Breaking Changes

• contracts:
  调整部分 CLI/MCP 诊断与报告摘要的字段与默认行为，以对齐新的指标与别名规则（详见文档与契约测试）。

Features

• diagnostics:
  增强诊断工具（strict 参数校验、错误码映射、grep-events 支持 ignoreCase/regex），并补 Playbook 与端到端示例。

Fixes

• release/ci:
  稳定包含 Orchestrator 定向测试与配置检测；修复一处 JSON 摘要别名契约（failedTasks）。

Internal

• lint: 将 vitest.config.ts 与 vitest.orchestrator.config.ts 纳入 ESLint
  TS 项目，消除 CI 噪音。
• tests: 增强 JSON 输出契约的覆盖率与零任务边界校验。

mcp-v1.6.0

1.6.0 (2025-10-06)

Features

• runtime: 默认禁用系统 fallback，启动时自动将内置 job.sh/start.sh
  及依赖落地到 .codex-father/，缺失时直接报错。
• runtime: 自动同步 job.d/、start.d/、lib/
  下的运行时脚本，检测手动修改后保留用户版本并给出警告。

Docs

• 更新环境变量参考、发行说明与 README，说明新的内置脚本托管策略及错误提示。

1.5.0 (2025-10-05)

Features

• mcp: guard handshake and add fallback runtime
  (190dafe)