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 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
- ## Why Codex Mate?
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
- STATE["sessions / trash / workflow runs"]
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.0.0.1:3737`, and browser auto-open is enabled by default.
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` | `127.0.0.1` | Web listen 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 welcome.
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
- ## 为什么选择 Codex Mate?
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
- PROXY["Built-in Proxy"]
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
- STATE["sessions / trash / workflow runs"]
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
- 默认监听 `127.0.0.1:3737`,并尝试自动打开浏览器。
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` | `127.0.0.1` | Web 服务监听地址 |
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
- 欢迎提交 Issue Pull Request
237
-
238
- - 英文更新日志:`doc/CHANGELOG.md`
239
- - 中文更新日志:`doc/CHANGELOG.zh-CN.md`
244
+ Issue Pull Request 可按需提交。
240
245
 
241
246
  ## License
242
247