codexmate 0.0.18 → 0.0.19
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.
- package/README.en.md +28 -15
- package/README.md +28 -23
- package/cli.js +498 -319
- package/package.json +1 -1
- package/web-ui/app.js +36 -260
- package/web-ui/index.html +274 -122
- package/web-ui/modules/config-mode.computed.mjs +1 -0
- package/web-ui/modules/skills.computed.mjs +26 -1
- package/web-ui/modules/skills.methods.mjs +154 -23
- package/web-ui/session-helpers.mjs +12 -0
- package/web-ui/styles.css +171 -2
- package/doc/CHANGELOG.md +0 -32
- package/doc/CHANGELOG.zh-CN.md +0 -34
package/README.en.md
CHANGED
|
@@ -23,17 +23,19 @@ Codex Mate is a local-first CLI + Web UI for unified management of:
|
|
|
23
23
|
- Codex provider/model switching and config writes
|
|
24
24
|
- Claude Code profiles (writes to `~/.claude/settings.json`)
|
|
25
25
|
- OpenClaw JSON5 profiles and workspace `AGENTS.md`
|
|
26
|
+
- Local skills market for Codex / Claude Code (target switching, local skills management, cross-app import, ZIP distribution)
|
|
26
27
|
- Local Codex/Claude sessions (list/filter/export/delete)
|
|
27
28
|
|
|
28
|
-
It works on local files directly and does not require cloud hosting.
|
|
29
|
+
It works on local files directly and does not require cloud hosting. The skills market is also local-first: it operates on local directories and does not depend on a remote marketplace.
|
|
29
30
|
|
|
30
|
-
##
|
|
31
|
+
## Comparison
|
|
31
32
|
|
|
32
33
|
| Dimension | Codex Mate | Manual File Editing |
|
|
33
34
|
| --- | --- | --- |
|
|
34
35
|
| Multi-tool management | Codex + Claude Code + OpenClaw in one entry | Different files and folders per tool |
|
|
35
36
|
| Operation mode | CLI + local Web UI | Manual TOML/JSON/JSON5 edits |
|
|
36
37
|
| Session handling | Browse/export/batch cleanup | Manual file location and processing |
|
|
38
|
+
| Skills reuse | Local skills market + cross-app import + ZIP distribution | Manual folder copy and reconciliation |
|
|
37
39
|
| Rollback readiness | Backup before first takeover | Easy to overwrite by mistake |
|
|
38
40
|
| Automation integration | MCP stdio (read-only by default) | Requires custom scripting |
|
|
39
41
|
|
|
@@ -52,6 +54,12 @@ It works on local files directly and does not require cloud hosting.
|
|
|
52
54
|
- Markdown export
|
|
53
55
|
- Session-level and message-level delete (supports batch)
|
|
54
56
|
|
|
57
|
+
**Skills Market**
|
|
58
|
+
- Switch the skills install target between Codex and Claude Code
|
|
59
|
+
- Inspect local installed skills, root paths, and status
|
|
60
|
+
- Scan importable sources from `Codex` / `Claude Code` / `Agents`
|
|
61
|
+
- Support cross-app import, ZIP import/export, and batch delete
|
|
62
|
+
|
|
55
63
|
**Engineering Utilities**
|
|
56
64
|
- MCP stdio domains (`tools`, `resources`, `prompts`)
|
|
57
65
|
- Built-in proxy controls (`proxy`)
|
|
@@ -74,15 +82,16 @@ flowchart TB
|
|
|
74
82
|
API["Local HTTP API"]
|
|
75
83
|
MCPS["MCP stdio Server"]
|
|
76
84
|
PROXY["Built-in Proxy"]
|
|
77
|
-
SERVICES["Config / Sessions / Skills / Workflow"]
|
|
85
|
+
SERVICES["Config / Sessions / Skills Market / Workflow"]
|
|
78
86
|
CORE["File IO / Network / Diff / Session Utils"]
|
|
79
87
|
end
|
|
80
88
|
|
|
81
89
|
subgraph Data["Local Files"]
|
|
82
|
-
CODEX["~/.codex"]
|
|
83
|
-
CLAUDE["~/.claude"]
|
|
84
|
-
OPENCLAW["~/.openclaw"]
|
|
85
|
-
|
|
90
|
+
CODEX["~/.codex/config + auth + models"]
|
|
91
|
+
CLAUDE["~/.claude/settings.json"]
|
|
92
|
+
OPENCLAW["~/.openclaw/*.json5 + ~/.openclaw/openclaw.json + workspace/AGENTS.md"]
|
|
93
|
+
SKILLS["~/.codex/skills / ~/.claude/skills / ~/.agents/skills"]
|
|
94
|
+
STATE["sessions / trash / workflow runs / skill exports"]
|
|
86
95
|
end
|
|
87
96
|
|
|
88
97
|
CLI --> ENTRY
|
|
@@ -100,6 +109,7 @@ flowchart TB
|
|
|
100
109
|
CORE --> CODEX
|
|
101
110
|
CORE --> CLAUDE
|
|
102
111
|
CORE --> OPENCLAW
|
|
112
|
+
CORE --> SKILLS
|
|
103
113
|
CORE --> STATE
|
|
104
114
|
```
|
|
105
115
|
|
|
@@ -114,7 +124,9 @@ codexmate status
|
|
|
114
124
|
codexmate run
|
|
115
125
|
```
|
|
116
126
|
|
|
117
|
-
Default listen address is `
|
|
127
|
+
Default listen address is `0.0.0.0:3737` for LAN access, and browser auto-open is enabled by default.
|
|
128
|
+
|
|
129
|
+
> Safety note: the unauthenticated management UI is exposed to your current LAN by default. Use trusted networks only; for local-only access, set `CODEXMATE_HOST=127.0.0.1` or pass `--host 127.0.0.1`.
|
|
118
130
|
|
|
119
131
|
### Run from source
|
|
120
132
|
|
|
@@ -170,8 +182,6 @@ codexmate codex --model gpt-5.3-codex --follow-up "step1" --follow-up "step2"
|
|
|
170
182
|
- Provider/model switching
|
|
171
183
|
- Model list management
|
|
172
184
|
- `~/.codex/AGENTS.md` editing
|
|
173
|
-
- `~/.codex/skills` management (filter, batch delete, cross-app import)
|
|
174
|
-
|
|
175
185
|
|
|
176
186
|
### Claude Code Mode
|
|
177
187
|
- Multi-profile management
|
|
@@ -188,6 +198,12 @@ codexmate codex --model gpt-5.3-codex --follow-up "step1" --follow-up "step2"
|
|
|
188
198
|
- Local pin/unpin with persistent storage and pinned-first ordering
|
|
189
199
|
- Search, filter, export, delete, batch cleanup
|
|
190
200
|
|
|
201
|
+
### Skills Market Tab
|
|
202
|
+
- Switch the skills install target between `Codex` and `Claude Code`
|
|
203
|
+
- Show the current local skills root, installed items, and importable items
|
|
204
|
+
- Scan importable sources under `Codex` / `Claude Code` / `Agents`
|
|
205
|
+
- Support cross-app import, ZIP import/export, and batch delete
|
|
206
|
+
|
|
191
207
|
## MCP
|
|
192
208
|
|
|
193
209
|
> Transport: `stdio`
|
|
@@ -218,7 +234,7 @@ codexmate mcp serve --allow-write
|
|
|
218
234
|
| Variable | Default | Description |
|
|
219
235
|
| --- | --- | --- |
|
|
220
236
|
| `CODEXMATE_PORT` | `3737` | Web server port |
|
|
221
|
-
| `CODEXMATE_HOST` | `
|
|
237
|
+
| `CODEXMATE_HOST` | `0.0.0.0` | Web listen host (set `127.0.0.1` for local-only access) |
|
|
222
238
|
| `CODEXMATE_NO_BROWSER` | unset | Set `1` to disable browser auto-open |
|
|
223
239
|
| `CODEXMATE_MCP_ALLOW_WRITE` | unset | Set `1` to allow MCP write tools by default |
|
|
224
240
|
| `CODEXMATE_FORCE_RESET_EXISTING_CONFIG` | `0` | Set `1` to force bootstrap reset of existing config |
|
|
@@ -232,10 +248,7 @@ codexmate mcp serve --allow-write
|
|
|
232
248
|
|
|
233
249
|
## Contributing
|
|
234
250
|
|
|
235
|
-
Issues and pull requests are
|
|
236
|
-
|
|
237
|
-
- English changelog: `doc/CHANGELOG.md`
|
|
238
|
-
- Chinese changelog: `doc/CHANGELOG.zh-CN.md`
|
|
251
|
+
Issues and pull requests are accepted.
|
|
239
252
|
|
|
240
253
|
## License
|
|
241
254
|
|
package/README.md
CHANGED
|
@@ -23,17 +23,19 @@ Codex Mate 提供一套本地优先的 CLI + Web UI,用于统一管理:
|
|
|
23
23
|
- Codex 的 provider / model 切换与配置写入
|
|
24
24
|
- Claude Code 配置方案(写入 `~/.claude/settings.json`)
|
|
25
25
|
- OpenClaw JSON5 配置与 Workspace `AGENTS.md`
|
|
26
|
+
- Codex / Claude Code Skills 市场(安装目标切换、本地 skills 管理、跨应用导入、ZIP 分发)
|
|
26
27
|
- Codex / Claude 本地会话浏览、筛选、导出、删除
|
|
27
28
|
|
|
28
|
-
项目不依赖云端托管,配置写入你的本地文件,便于审计和回滚。
|
|
29
|
+
项目不依赖云端托管,配置写入你的本地文件,便于审计和回滚。Skills 市场同样坚持本地优先,只操作本地目录,不依赖远程在线市场。
|
|
29
30
|
|
|
30
|
-
##
|
|
31
|
+
## 功能对比
|
|
31
32
|
|
|
32
33
|
| 维度 | Codex Mate | 手动维护配置 |
|
|
33
34
|
| --- | --- | --- |
|
|
34
35
|
| 多工具管理 | Codex + Claude Code + OpenClaw 统一入口 | 多文件、多目录分散修改 |
|
|
35
36
|
| 使用方式 | CLI + 本地 Web UI | 纯手改 TOML / JSON / JSON5 |
|
|
36
37
|
| 会话处理 | 支持浏览、导出、批量清理 | 需要手动定位和处理文件 |
|
|
38
|
+
| Skills 复用 | 本地 Skills 市场 + 跨应用导入 + ZIP 分发 | 目录手动复制,容易遗漏 |
|
|
37
39
|
| 可回滚性 | 首次接管前自动备份 | 易误覆盖、回滚成本高 |
|
|
38
40
|
| 自动化接入 | 提供 MCP stdio(默认只读) | 需自行封装脚本 |
|
|
39
41
|
|
|
@@ -52,10 +54,14 @@ Codex Mate 提供一套本地优先的 CLI + Web UI,用于统一管理:
|
|
|
52
54
|
- 会话导出 Markdown
|
|
53
55
|
- 会话与消息级删除(支持批量)
|
|
54
56
|
|
|
57
|
+
**Skills 市场**
|
|
58
|
+
- 在 Codex 与 Claude Code 之间切换 skills 安装目标
|
|
59
|
+
- 查看本地已安装 skills、根目录与状态
|
|
60
|
+
- 扫描 `Codex` / `Claude Code` / `Agents` 可导入来源
|
|
61
|
+
- 支持跨应用导入、ZIP 导入 / 导出、批量删除
|
|
62
|
+
|
|
55
63
|
**工程能力**
|
|
56
64
|
- MCP stdio 能力(tools/resources/prompts)
|
|
57
|
-
- 内建代理配置与状态控制(`proxy`)
|
|
58
|
-
- 认证档案管理(`auth`)
|
|
59
65
|
- Zip 压缩/解压(优先系统工具,失败回退 JS 库)
|
|
60
66
|
|
|
61
67
|
## 架构总览
|
|
@@ -66,40 +72,38 @@ flowchart TB
|
|
|
66
72
|
CLI["CLI"]
|
|
67
73
|
WEB["Web UI"]
|
|
68
74
|
MCP["MCP Client"]
|
|
69
|
-
OAI["Codex / OpenAI Client"]
|
|
70
75
|
end
|
|
71
76
|
|
|
72
77
|
subgraph Runtime["Codex Mate Runtime"]
|
|
73
78
|
ENTRY["cli.js Entry"]
|
|
74
79
|
API["Local HTTP API"]
|
|
75
80
|
MCPS["MCP stdio Server"]
|
|
76
|
-
|
|
77
|
-
SERVICES["Config / Sessions / Skills / Workflow"]
|
|
81
|
+
SERVICES["Config / Sessions / Skills Market / Workflow"]
|
|
78
82
|
CORE["File IO / Network / Diff / Session Utils"]
|
|
79
83
|
end
|
|
80
84
|
|
|
81
85
|
subgraph State["Local State"]
|
|
82
|
-
CODEX["~/.codex"]
|
|
83
|
-
CLAUDE["~/.claude"]
|
|
84
|
-
OPENCLAW["~/.openclaw"]
|
|
85
|
-
|
|
86
|
+
CODEX["~/.codex/config + auth + models"]
|
|
87
|
+
CLAUDE["~/.claude/settings.json"]
|
|
88
|
+
OPENCLAW["~/.openclaw/*.json5 + ~/.openclaw/openclaw.json + workspace/AGENTS.md"]
|
|
89
|
+
SKILLS["~/.codex/skills / ~/.claude/skills / ~/.agents/skills"]
|
|
90
|
+
STATE["sessions / trash / workflow runs / skill exports"]
|
|
86
91
|
end
|
|
87
92
|
|
|
88
93
|
CLI --> ENTRY
|
|
89
94
|
WEB -->|GET / + POST /api| API
|
|
90
95
|
MCP -->|stdio JSON-RPC| MCPS
|
|
91
|
-
OAI -->|HTTP /v1| PROXY
|
|
92
96
|
|
|
93
97
|
ENTRY --> SERVICES
|
|
94
98
|
API --> SERVICES
|
|
95
99
|
MCPS --> SERVICES
|
|
96
|
-
PROXY --> CORE
|
|
97
100
|
|
|
98
101
|
SERVICES --> CORE
|
|
99
102
|
|
|
100
103
|
CORE --> CODEX
|
|
101
104
|
CORE --> CLAUDE
|
|
102
105
|
CORE --> OPENCLAW
|
|
106
|
+
CORE --> SKILLS
|
|
103
107
|
CORE --> STATE
|
|
104
108
|
```
|
|
105
109
|
|
|
@@ -114,7 +118,9 @@ codexmate status
|
|
|
114
118
|
codexmate run
|
|
115
119
|
```
|
|
116
120
|
|
|
117
|
-
默认监听 `
|
|
121
|
+
默认监听 `0.0.0.0:3737`,支持局域网访问,并尝试自动打开浏览器。
|
|
122
|
+
|
|
123
|
+
> 安全提示:默认监听会在当前局域网暴露未鉴权的管理界面。若包含 API Key、provider 配置或 skills 管理,请仅在可信网络中使用;如需仅本机访问,可设置 `CODEXMATE_HOST=127.0.0.1` 或启动时传入 `--host 127.0.0.1`。
|
|
118
124
|
|
|
119
125
|
### 从源码运行
|
|
120
126
|
|
|
@@ -144,8 +150,6 @@ npm start run --no-browser
|
|
|
144
150
|
| `codexmate add <name> <URL> [API_KEY]` | 添加提供商 |
|
|
145
151
|
| `codexmate delete <name>` | 删除提供商 |
|
|
146
152
|
| `codexmate claude <BaseURL> <API_KEY> [model]` | 写入 Claude Code 配置 |
|
|
147
|
-
| `codexmate auth <list\|import\|switch\|delete\|status>` | 认证档案管理 |
|
|
148
|
-
| `codexmate proxy <status\|set\|apply\|enable\|start\|stop>` | 内建代理管理 |
|
|
149
153
|
| `codexmate workflow <list\|get\|validate\|run\|runs>` | MCP 工作流管理 |
|
|
150
154
|
| `codexmate codex [args...] [--follow-up <文本> 可重复]` | Codex CLI 透传入口(默认补 `--yolo`,可追加 queued follow-up) |
|
|
151
155
|
| `codexmate qwen [args...]` | Qwen CLI 透传入口 |
|
|
@@ -170,8 +174,6 @@ codexmate codex --model gpt-5.3-codex --follow-up "步骤1" --follow-up "步骤2
|
|
|
170
174
|
- provider / model 切换
|
|
171
175
|
- 模型管理
|
|
172
176
|
- `~/.codex/AGENTS.md` 编辑
|
|
173
|
-
- `~/.codex/skills` 管理(筛选、批量删除、跨应用导入)
|
|
174
|
-
|
|
175
177
|
|
|
176
178
|
### Claude Code 配置模式
|
|
177
179
|
- 多配置方案管理
|
|
@@ -188,6 +190,12 @@ codexmate codex --model gpt-5.3-codex --follow-up "步骤1" --follow-up "步骤2
|
|
|
188
190
|
- 支持本地会话置顶、持久化保存与置顶优先排序
|
|
189
191
|
- 搜索、筛选、导出、删除、批量清理
|
|
190
192
|
|
|
193
|
+
### Skills 市场标签页
|
|
194
|
+
- 在 `Codex` 与 `Claude Code` 之间切换 skills 安装目标
|
|
195
|
+
- 展示当前目标的本地 skills 根目录、已安装项和可导入项
|
|
196
|
+
- 扫描 `Codex` / `Claude Code` / `Agents` 目录中的可导入来源
|
|
197
|
+
- 支持跨应用导入、ZIP 导入 / 导出、批量删除
|
|
198
|
+
|
|
191
199
|
## MCP
|
|
192
200
|
|
|
193
201
|
> 传输:`stdio`
|
|
@@ -219,7 +227,7 @@ codexmate mcp serve --allow-write
|
|
|
219
227
|
| 变量 | 默认值 | 说明 |
|
|
220
228
|
| --- | --- | --- |
|
|
221
229
|
| `CODEXMATE_PORT` | `3737` | Web 服务端口 |
|
|
222
|
-
| `CODEXMATE_HOST` | `
|
|
230
|
+
| `CODEXMATE_HOST` | `0.0.0.0` | Web 服务监听地址(如需仅本机访问,显式设为 `127.0.0.1`) |
|
|
223
231
|
| `CODEXMATE_NO_BROWSER` | 未设置 | 设为 `1` 后不自动打开浏览器 |
|
|
224
232
|
| `CODEXMATE_MCP_ALLOW_WRITE` | 未设置 | 设为 `1` 后默认允许 MCP 写工具 |
|
|
225
233
|
| `CODEXMATE_FORCE_RESET_EXISTING_CONFIG` | `0` | 设为 `1` 时首次可强制重建托管配置 |
|
|
@@ -233,10 +241,7 @@ codexmate mcp serve --allow-write
|
|
|
233
241
|
|
|
234
242
|
## 参与贡献
|
|
235
243
|
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
- 英文更新日志:`doc/CHANGELOG.md`
|
|
239
|
-
- 中文更新日志:`doc/CHANGELOG.zh-CN.md`
|
|
244
|
+
Issue 与 Pull Request 可按需提交。
|
|
240
245
|
|
|
241
246
|
## License
|
|
242
247
|
|