npm - codexmate - Versions diffs - 0.0.10 → 0.0.13 - Mend

codexmate 0.0.10 → 0.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (50) hide show

package/README.md +52 -12
package/README.zh-CN.md +52 -12
package/cli.js +3491 -563
package/{CHANGELOG.md → doc/CHANGELOG.md} +6 -0
package/{CHANGELOG.zh-CN.md → doc/CHANGELOG.zh-CN.md} +6 -0
package/lib/mcp-stdio.js +440 -0
package/package.json +22 -2
package/res/logo.png +0 -0
package/web-ui/app.js +1171 -149
package/web-ui/index.html +1605 -0
package/web-ui/logic.mjs +21 -21
package/web-ui/styles.css +3213 -0
package/web-ui.html +7 -3967
package/.github/ISSUE_TEMPLATE/bug_report.md +0 -27
package/.github/ISSUE_TEMPLATE/feature_request.md +0 -17
package/.github/workflows/ci.yml +0 -26
package/.github/workflows/release.yml +0 -159
package/.planning/.fix-attempts +0 -1
package/.planning/.lock +0 -6
package/.planning/.verify-cache.json +0 -14
package/.planning/CHECKPOINT.json +0 -46
package/.planning/DESIGN.md +0 -26
package/.planning/HISTORY.json +0 -124
package/.planning/PLAN.md +0 -69
package/.planning/REVIEW.md +0 -41
package/.planning/STATE.md +0 -12
package/.planning/STATS.json +0 -13
package/.planning/VERIFICATION.md +0 -70
package/.planning/daude-code-plan.md +0 -51
package/.planning/research/architecture.md +0 -32
package/.planning/research/conventions.md +0 -36
package/.planning/task_1-REVIEW.md +0 -29
package/.planning/task_1-SUMMARY.md +0 -32
package/.planning/task_2-REVIEW.md +0 -24
package/.planning/task_2-SUMMARY.md +0 -37
package/.planning/task_3-REVIEW.md +0 -25
package/.planning/task_3-SUMMARY.md +0 -31
package/cmd/publish-npm.cmd +0 -65
package/tests/e2e/helpers.js +0 -214
package/tests/e2e/recent-health.e2e.js +0 -142
package/tests/e2e/run.js +0 -154
package/tests/e2e/test-claude.js +0 -21
package/tests/e2e/test-config.js +0 -124
package/tests/e2e/test-health-speed.js +0 -79
package/tests/e2e/test-openclaw.js +0 -47
package/tests/e2e/test-session-search.js +0 -114
package/tests/e2e/test-sessions.js +0 -69
package/tests/e2e/test-setup.js +0 -159
package/tests/unit/run.mjs +0 -29
package/tests/unit/web-ui-logic.test.mjs +0 -186

package/README.md CHANGED Viewed

@@ -1,11 +1,24 @@
 # Codex Mate
-> A lightweight AI configuration assistant: quickly switch Codex providers/models and Claude Code configs, with a unified session browser
+<div align="center">
-[![Build](https://img.shields.io/github/actions/workflow/status/ymkiux/codexmate/release.yml?label=build)](https://github.com/ymkiux/codexmate/actions/workflows/release.yml) [![Version](https://img.shields.io/npm/v/codexmate?label=version&registry_uri=https%3A%2F%2Fregistry.npmjs.org)](https://www.npmjs.com/package/codexmate) [![Status](https://img.shields.io/badge/status-alpha-orange)](https://github.com/ymkiux/codexmate)
-[![Maintain](https://img.shields.io/github/commit-activity/m/ymkiux/codexmate?label=maintain%2Fmonth)](https://github.com/ymkiux/codexmate/commits) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
+<img src="res/logo.png" alt="Codex Mate logo" width="110">
-English | [Chinese](README.zh-CN.md)
+[![Build](https://img.shields.io/github/actions/workflow/status/ymkiux/codexmate/release.yml?label=build)](https://github.com/ymkiux/codexmate/actions/workflows/release.yml)
+[![Version](https://img.shields.io/npm/v/codexmate?label=version&registry_uri=https%3A%2F%2Fregistry.npmjs.org)](https://www.npmjs.com/package/codexmate)
+[![Downloads](https://img.shields.io/npm/dt/codexmate?label=downloads)](https://www.npmjs.com/package/codexmate)
+[![Status](https://img.shields.io/badge/status-alpha-orange)](https://github.com/ymkiux/codexmate)
+[![Maintain](https://img.shields.io/github/commit-activity/m/ymkiux/codexmate?label=maintain%2Fmonth)](https://github.com/ymkiux/codexmate/commits)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
+**A lightweight AI configuration assistant: quickly switch Codex providers/models and Claude Code configs, with a unified session browser**
+</div>
+---
+<p align="center">English · <a href="README.zh-CN.md">中文版</a></p>
 ![Codex Mate Web UI](res/screenshot.png)
@@ -15,12 +28,12 @@ One tool to switch Codex/Claude Code providers & models and manage/browse local
 ## What You Get
-- One-command provider/model switching
-- Local config control with backups
-- Lightweight Web UI instead of heavy clients
-- Unified session browser (view/export/resume when available)
-- Session management: list/filter/export/delete local sessions; keyword search supports Codex and Claude
-- New in 0.0.9: Claude sessions are searchable by keywords (e.g., `claude code`, `claude-code`, numeric tokens)
+- One-command provider/model switching
+- Local config control with backups
+- Lightweight Web UI instead of heavy clients
+- Unified session browser (view/export/resume when available)
+- Session management: list/filter/export/delete local sessions; keyword search supports Codex and Claude
+- New in 0.0.10: Claude sessions are searchable by keywords (e.g., `claude code`, `claude-code`, numeric tokens)
 ## Feature Overview
@@ -29,7 +42,7 @@ One tool to switch Codex/Claude Code providers & models and manage/browse local
 | Codex Config | Switching providers/models is painful | Provider/model switching, model management, CLI + Web entry points, template-confirmed writes |
 | Claude Code Config | Multiple profiles and inconsistent write paths | Profile management, default write to `~/.claude/settings.json` |
 | OpenClaw Config | OpenClaw configs are scattered | JSON5 profiles, apply to `~/.openclaw/openclaw.json`, AGENTS workspace management |
-| Session Browser | Local sessions are hard to track | List/filter sessions, keyword search (Codex + Claude), export to Markdown, copy resume command (when available), delete and batch cleanup |
+| Session Browser | Local sessions are hard to track | List/filter sessions, keyword search (Codex + Claude), export to Markdown, copy resume command (when available), delete and batch cleanup |
 | Utilities | Compression/extraction requires extra tools | 7-Zip preferred, JS fallback |
 ## Why Codex Mate
@@ -156,8 +169,30 @@ npm link
 | `codexmate add-model <model>` | Add a model |
 | `codexmate delete-model <model>` | Delete a model |
 | `codexmate run` | Start the Web UI |
+| `codexmate mcp [serve] [--transport stdio] [--allow-write\|--read-only]` | Start MCP server over stdio (default read-only) |
 | `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | Export a session to Markdown |
+## MCP (stdio)
+- Transport: `stdio` only
+- Default mode: read-only tool set
+- Write tools: enable by `--allow-write` or `CODEXMATE_MCP_ALLOW_WRITE=1`
+- Sensitive fields in `codexmate.claude.settings.get` are returned as masked values
+```bash
+# Read-only (recommended for external agents)
+codexmate mcp serve --read-only
+# Enable write tools explicitly
+codexmate mcp serve --allow-write
+```
+Provided MCP domains:
+- `tools`: status/provider/model/session/auth/proxy and config operations
+- `resources`: status/providers/sessions snapshots
+- `prompts`: built-in diagnose/switch/export templates
 ## Web UI
 Start the Web UI (auto opens browser):
@@ -358,7 +393,7 @@ Note: 7-Zip is optional. If missing, the built-in JS library is used. `--max` on
 ## Release (GitHub Actions)
-Create a tag that matches `package.json` (for example `v0.0.8`). Then run the `release` workflow in GitHub Actions and input that tag. It will create a GitHub Release and attach the `npm pack` `.tgz` artifact.
+Create a tag that matches `package.json` (for example `v0.0.9`). Then run the `release` workflow in GitHub Actions and input that tag. It will create a GitHub Release and attach the `npm pack` `.tgz` artifact.
 ## License
@@ -368,6 +403,11 @@ Apache-2.0 © [ymkiux](https://github.com/ymkiux)
 Issues and pull requests are welcome.
+## Changelog
+See [doc/CHANGELOG.md](doc/CHANGELOG.md) for the English version.
+See [doc/CHANGELOG.zh-CN.md](doc/CHANGELOG.zh-CN.md) for the Chinese version.
 ---
 Made with [ymkiux](https://github.com/ymkiux)

package/README.zh-CN.md CHANGED Viewed

@@ -1,11 +1,24 @@
 # Codex Mate
-> 轻量级 AI 工具配置助手：快速切换 Codex 提供商/模型与 Claude Code 配置，并统一管理两者会话
+<div align="center">
-[![Build](https://img.shields.io/github/actions/workflow/status/ymkiux/codexmate/release.yml?label=build)](https://github.com/ymkiux/codexmate/actions/workflows/release.yml) [![Version](https://img.shields.io/npm/v/codexmate?label=version&registry_uri=https%3A%2F%2Fregistry.npmjs.org)](https://www.npmjs.com/package/codexmate) [![Status](https://img.shields.io/badge/status-alpha-orange)](https://github.com/ymkiux/codexmate)
-[![Maintain](https://img.shields.io/github/commit-activity/m/ymkiux/codexmate?label=maintain%2Fmonth)](https://github.com/ymkiux/codexmate/commits) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
+<img src="res/logo.png" alt="Codex Mate logo" width="110">
-[English](README.md) | 中文
+[![Build](https://img.shields.io/github/actions/workflow/status/ymkiux/codexmate/release.yml?label=build)](https://github.com/ymkiux/codexmate/actions/workflows/release.yml)
+[![Version](https://img.shields.io/npm/v/codexmate?label=version&registry_uri=https%3A%2F%2Fregistry.npmjs.org)](https://www.npmjs.com/package/codexmate)
+[![Downloads](https://img.shields.io/npm/dt/codexmate?label=downloads)](https://www.npmjs.com/package/codexmate)
+[![Status](https://img.shields.io/badge/status-alpha-orange)](https://github.com/ymkiux/codexmate)
+[![Maintain](https://img.shields.io/github/commit-activity/m/ymkiux/codexmate?label=maintain%2Fmonth)](https://github.com/ymkiux/codexmate/commits)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
+**轻量级 AI 配置助手：快速切换 Codex 提供商/模型与 Claude Code 配置，统一浏览本地会话**
+</div>
+---
+<p align="center"><a href="README.md">English</a> · 中文</p>
 ![Codex Mate Web UI](res/screenshot.png)
@@ -16,17 +29,17 @@ Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命
 ## 你能获得什么
 - 更快的模型/提供商切换
-- 更可控的本地配置管理
-- 可视化 Web 操作，降低命令行负担
-- 配置变更可回溯、有备份
-- Codex + Claude Code 统一会话浏览（查看/导出/可用时复制恢复命令）
- - 0.0.9 新增：Claude 会话支持关键词搜索（含 `claude code` / `claude-code` / 数字关键词）
+- 更可控的本地配置管理
+- 可视化 Web 操作，降低命令行负担
+- 配置变更可回溯、有备份
+- Codex + Claude Code 统一会话浏览（查看/导出/可用时复制恢复命令）
+ - 0.0.10 新增：Claude 会话支持关键词搜索（含 `claude code` / `claude-code` / 数字关键词）
 ## 概览
 一键切换 Codex/Claude Code 提供商与模型，并把本地会话统一管理/浏览/导出。
-- 会话管理：列表/筛选/导出/删除 Codex/Claude 本地会话；关键词搜索支持 Codex/Claude
+- 会话管理：列表/筛选/导出/删除 Codex/Claude 本地会话；关键词搜索支持 Codex/Claude
 ## 功能总览
@@ -35,7 +48,7 @@ Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命
 | Codex 配置 | 多提供商/多模型切换麻烦 | 提供商/模型切换、模型管理、CLI + Web 双入口、模板确认写入 |
 | Claude Code 配置 | 多方案共存、写入路径不统一 | 多配置方案管理、默认写入 `~/.claude/settings.json` |
 | OpenClaw 配置 | OpenClaw 配置分散 | JSON5 多配置管理、应用到 `~/.openclaw/openclaw.json`、Workspace 指令文件管理 |
-| 会话浏览 | 本地会话难以追踪 | 会话列表/筛选、关键词搜索（支持 Codex/Claude）、Markdown 导出、可用时复制恢复命令、删除与批量清理 |
+| 会话浏览 | 本地会话难以追踪 | 会话列表/筛选、关键词搜索（支持 Codex/Claude）、Markdown 导出、可用时复制恢复命令、删除与批量清理 |
 | 附属工具 | 压缩/解压需额外工具 | 优先 7-Zip，JS 库兜底 |
 ## 为什么选 Codex Mate
@@ -162,8 +175,30 @@ npm link
 | `codexmate add-model <模型名称>` | 添加模型 |
 | `codexmate delete-model <模型名称>` | 删除模型 |
 | `codexmate run` | 启动 Web 界面 |
+| `codexmate mcp [serve] [--transport stdio] [--allow-write\|--read-only]` | 启动 MCP stdio 服务（默认只读） |
 | `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | 导出指定会话为 Markdown |
+## MCP（stdio）
+- 传输方式：仅支持 `stdio`
+- 默认模式：只读工具集
+- 写入工具开启方式：`--allow-write` 或 `CODEXMATE_MCP_ALLOW_WRITE=1`
+- `codexmate.claude.settings.get` 的敏感字段默认脱敏返回
+```bash
+# 只读（推荐给外部 Agent 接入）
+codexmate mcp serve --read-only
+# 显式开启写工具
+codexmate mcp serve --allow-write
+```
+当前提供的 MCP 能力：
+- `tools`：状态/提供商/模型/会话/认证/代理/配置等操作
+- `resources`：status/providers/sessions 快照资源
+- `prompts`：诊断/安全切换/会话导出模板
 ## Web 界面
 启动 Web 界面（自动打开浏览器）：
@@ -364,7 +399,7 @@ codexmate unzip ./backup.zip D:/restored
 ## 发布（GitHub Actions）
-创建与 `package.json` 版本一致的标签（例如 `v0.0.8`）。然后在 GitHub Actions 中手动运行 `release` 工作流并输入该标签，系统会创建 GitHub Release，并附带 `npm pack` 生成的 `.tgz` 产物。
+创建与 `package.json` 版本一致的标签（例如 `v0.0.9`）。然后在 GitHub Actions 中手动运行 `release` 工作流并输入该标签，系统会创建 GitHub Release，并附带 `npm pack` 生成的 `.tgz` 产物。
 ## 许可证
@@ -374,6 +409,11 @@ Apache-2.0 © [ymkiux](https://github.com/ymkiux)
 欢迎提交 Issue 和 Pull Request。
+## 更新日志
+英文版见 [doc/CHANGELOG.md](doc/CHANGELOG.md)。
+中文版见 [doc/CHANGELOG.zh-CN.md](doc/CHANGELOG.zh-CN.md)。
 ---
 Made with [ymkiux](https://github.com/ymkiux)