codexmate 0.0.17 → 0.0.19

package/README.en.md

@@ -4,9 +4,6 @@
 
 **Local configuration and session manager for Codex / Claude Code / OpenClaw**
 
-Current version: `v0.0.17`
-
-
 [![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?label=build)](https://github.com/SakuraByteCore/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)
@@ -26,17 +23,19 @@ Codex Mate is a local-first CLI + Web UI for unified management of:
 - Codex provider/model switching and config writes
 - Claude Code profiles (writes to `~/.claude/settings.json`)
 - OpenClaw JSON5 profiles and workspace `AGENTS.md`
+- Local skills market for Codex / Claude Code (target switching, local skills management, cross-app import, ZIP distribution)
 - Local Codex/Claude sessions (list/filter/export/delete)
 
-It works on local files directly and does not require cloud hosting.
+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.
 
-## Why Codex Mate?
+## Comparison
 
 | Dimension | Codex Mate | Manual File Editing |
 | --- | --- | --- |
 | Multi-tool management | Codex + Claude Code + OpenClaw in one entry | Different files and folders per tool |
 | Operation mode | CLI + local Web UI | Manual TOML/JSON/JSON5 edits |
 | Session handling | Browse/export/batch cleanup | Manual file location and processing |
+| Skills reuse | Local skills market + cross-app import + ZIP distribution | Manual folder copy and reconciliation |
 | Rollback readiness | Backup before first takeover | Easy to overwrite by mistake |
 | Automation integration | MCP stdio (read-only by default) | Requires custom scripting |
 
@@ -50,10 +49,17 @@ It works on local files directly and does not require cloud hosting.
 
 **Session Management**
 - Unified Codex + Claude session list
+- Local session pinning with persistent pinned state and pinned-first ordering
 - Keyword/source/cwd filters
 - Markdown export
 - Session-level and message-level delete (supports batch)
 
+**Skills Market**
+- Switch the skills install target between Codex and Claude Code
+- Inspect local installed skills, root paths, and status
+- Scan importable sources from `Codex` / `Claude Code` / `Agents`
+- Support cross-app import, ZIP import/export, and batch delete
+
 **Engineering Utilities**
 - MCP stdio domains (`tools`, `resources`, `prompts`)
 - Built-in proxy controls (`proxy`)
@@ -63,25 +69,48 @@ It works on local files directly and does not require cloud hosting.
 ## Architecture
 
 ```mermaid
-flowchart LR
-    A[CLI: codexmate] --> B[Local config files]
-    A --> C[Local Web UI]
-    C --> D[Built-in HTTP API]
-    D --> B
-    D --> E[Session indexing/export]
-    A --> F[MCP stdio server]
-
-    subgraph Local Files
-      B1[~/.codex/config.toml]
-      B2[~/.claude/settings.json]
-      B3[~/.openclaw/openclaw.json]
-      B4[sessions/*.jsonl]
+flowchart TB
+    subgraph Interfaces["Entry Surfaces"]
+      CLI["CLI"]
+      WEB["Web UI"]
+      MCP["MCP Client"]
+      OAI["Codex / OpenAI Client"]
+    end
+
+    subgraph Runtime["Codex Mate Runtime"]
+      ENTRY["cli.js Entry"]
+      API["Local HTTP API"]
+      MCPS["MCP stdio Server"]
+      PROXY["Built-in Proxy"]
+      SERVICES["Config / Sessions / Skills Market / Workflow"]
+      CORE["File IO / Network / Diff / Session Utils"]
+    end
+
+    subgraph Data["Local Files"]
+      CODEX["~/.codex/config + auth + models"]
+      CLAUDE["~/.claude/settings.json"]
+      OPENCLAW["~/.openclaw/*.json5 + ~/.openclaw/openclaw.json + workspace/AGENTS.md"]
+      SKILLS["~/.codex/skills / ~/.claude/skills / ~/.agents/skills"]
+      STATE["sessions / trash / workflow runs / skill exports"]
     end
 
-    B --> B1
-    B --> B2
-    B --> B3
-    E --> B4
+    CLI --> ENTRY
+    WEB -->|GET / + POST /api| API
+    MCP -->|stdio JSON-RPC| MCPS
+    OAI -->|HTTP /v1| PROXY
+
+    ENTRY --> SERVICES
+    API --> SERVICES
+    MCPS --> SERVICES
+    PROXY --> CORE
+
+    SERVICES --> CORE
+
+    CORE --> CODEX
+    CORE --> CLAUDE
+    CORE --> OPENCLAW
+    CORE --> SKILLS
+    CORE --> STATE
 ```
 
 ## Quick Start
@@ -95,7 +124,9 @@ codexmate status
 codexmate run
 ```
 
-Default listen address is `127.0.0.1:3737`, and browser auto-open is enabled by default.
+Default listen address is `0.0.0.0:3737` for LAN access, and browser auto-open is enabled by default.
+
+> 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`.
 
 ### Run from source
 
@@ -103,14 +134,13 @@ Default listen address is `127.0.0.1:3737`, and browser auto-open is enabled by
 git clone https://github.com/SakuraByteCore/codexmate.git
 cd codexmate
 npm install
-npm link
-codexmate run
+npm start run
 ```
 
 ### Tests / CI (service only)
 
 ```bash
-codexmate run --no-browser
+npm start run --no-browser
 ```
 
 > Convention: automated tests validate service and API behavior only, without opening browser pages.
@@ -152,8 +182,6 @@ codexmate codex --model gpt-5.3-codex --follow-up "step1" --follow-up "step2"
 - Provider/model switching
 - Model list management
 - `~/.codex/AGENTS.md` editing
-- `~/.codex/skills` management (filter, batch delete, cross-app import)
-
 
 ### Claude Code Mode
 - Multi-profile management
@@ -167,8 +195,15 @@ codexmate codex --model gpt-5.3-codex --follow-up "step1" --follow-up "step2"
 
 ### Sessions Mode
 - Unified Codex + Claude sessions
+- Local pin/unpin with persistent storage and pinned-first ordering
 - Search, filter, export, delete, batch cleanup
 
+### Skills Market Tab
+- Switch the skills install target between `Codex` and `Claude Code`
+- Show the current local skills root, installed items, and importable items
+- Scan importable sources under `Codex` / `Claude Code` / `Agents`
+- Support cross-app import, ZIP import/export, and batch delete
+
 ## MCP
 
 > Transport: `stdio`
@@ -199,7 +234,7 @@ codexmate mcp serve --allow-write
 | Variable | Default | Description |
 | --- | --- | --- |
 | `CODEXMATE_PORT` | `3737` | Web server port |
-| `CODEXMATE_HOST` | `127.0.0.1` | Web listen host |
+| `CODEXMATE_HOST` | `0.0.0.0` | Web listen host (set `127.0.0.1` for local-only access) |
 | `CODEXMATE_NO_BROWSER` | unset | Set `1` to disable browser auto-open |
 | `CODEXMATE_MCP_ALLOW_WRITE` | unset | Set `1` to allow MCP write tools by default |
 | `CODEXMATE_FORCE_RESET_EXISTING_CONFIG` | `0` | Set `1` to force bootstrap reset of existing config |
@@ -213,10 +248,7 @@ codexmate mcp serve --allow-write
 
 ## Contributing
 
-Issues and pull requests are welcome.
-
-- English changelog: `doc/CHANGELOG.md`
-- Chinese changelog: `doc/CHANGELOG.zh-CN.md`
+Issues and pull requests are accepted.
 
 ## License
 

package/README.md

@@ -4,9 +4,6 @@
 
 **Codex / Claude Code / OpenClaw 的本地配置与会话管理工具**
 
-当前版本：`v0.0.17`
-
-
 [![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?label=build)](https://github.com/SakuraByteCore/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)
@@ -26,17 +23,19 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 - Codex 的 provider / model 切换与配置写入
 - Claude Code 配置方案（写入 `~/.claude/settings.json`）
 - OpenClaw JSON5 配置与 Workspace `AGENTS.md`
+- Codex / Claude Code Skills 市场（安装目标切换、本地 skills 管理、跨应用导入、ZIP 分发）
 - Codex / Claude 本地会话浏览、筛选、导出、删除
 
-项目不依赖云端托管，配置写入你的本地文件，便于审计和回滚。
+项目不依赖云端托管，配置写入你的本地文件，便于审计和回滚。Skills 市场同样坚持本地优先，只操作本地目录，不依赖远程在线市场。
 
-## 为什么选择 Codex Mate？
+## 功能对比
 
 | 维度 | Codex Mate | 手动维护配置 |
 | --- | --- | --- |
 | 多工具管理 | Codex + Claude Code + OpenClaw 统一入口 | 多文件、多目录分散修改 |
 | 使用方式 | CLI + 本地 Web UI | 纯手改 TOML / JSON / JSON5 |
 | 会话处理 | 支持浏览、导出、批量清理 | 需要手动定位和处理文件 |
+| Skills 复用 | 本地 Skills 市场 + 跨应用导入 + ZIP 分发 | 目录手动复制，容易遗漏 |
 | 可回滚性 | 首次接管前自动备份 | 易误覆盖、回滚成本高 |
 | 自动化接入 | 提供 MCP stdio（默认只读） | 需自行封装脚本 |
 
@@ -50,38 +49,62 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 
 **会话管理**
 - 同页查看 Codex 与 Claude 会话
+- 支持本地会话置顶，置顶状态持久化保存并优先排序显示
 - 关键词搜索、来源筛选、cwd 路径筛选
 - 会话导出 Markdown
 - 会话与消息级删除（支持批量）
 
+**Skills 市场**
+- 在 Codex 与 Claude Code 之间切换 skills 安装目标
+- 查看本地已安装 skills、根目录与状态
+- 扫描 `Codex` / `Claude Code` / `Agents` 可导入来源
+- 支持跨应用导入、ZIP 导入 / 导出、批量删除
+
 **工程能力**
 - MCP stdio 能力（tools/resources/prompts）
-- 内建代理配置与状态控制（`proxy`）
-- 认证档案管理（`auth`）
 - Zip 压缩/解压（优先系统工具，失败回退 JS 库）
 
 ## 架构总览
 
 ```mermaid
-flowchart LR
-    A[CLI: codexmate] --> B[本地配置文件]
-    A --> C[本地 Web UI]
-    C --> D[内建 HTTP API]
-    D --> B
-    D --> E[会话索引与导出]
-    A --> F[MCP stdio server]
-
-    subgraph Local Files
-      B1[~/.codex/config.toml]
-      B2[~/.claude/settings.json]
-      B3[~/.openclaw/openclaw.json]
-      B4[sessions/*.jsonl]
+flowchart TB
+    subgraph Interfaces["入口"]
+      CLI["CLI"]
+      WEB["Web UI"]
+      MCP["MCP Client"]
+    end
+
+    subgraph Runtime["Codex Mate Runtime"]
+      ENTRY["cli.js Entry"]
+      API["Local HTTP API"]
+      MCPS["MCP stdio Server"]
+      SERVICES["Config / Sessions / Skills Market / Workflow"]
+      CORE["File IO / Network / Diff / Session Utils"]
+    end
+
+    subgraph State["Local State"]
+      CODEX["~/.codex/config + auth + models"]
+      CLAUDE["~/.claude/settings.json"]
+      OPENCLAW["~/.openclaw/*.json5 + ~/.openclaw/openclaw.json + workspace/AGENTS.md"]
+      SKILLS["~/.codex/skills / ~/.claude/skills / ~/.agents/skills"]
+      STATE["sessions / trash / workflow runs / skill exports"]
     end
 
-    B --> B1
-    B --> B2
-    B --> B3
-    E --> B4
+    CLI --> ENTRY
+    WEB -->|GET / + POST /api| API
+    MCP -->|stdio JSON-RPC| MCPS
+
+    ENTRY --> SERVICES
+    API --> SERVICES
+    MCPS --> SERVICES
+
+    SERVICES --> CORE
+
+    CORE --> CODEX
+    CORE --> CLAUDE
+    CORE --> OPENCLAW
+    CORE --> SKILLS
+    CORE --> STATE
 ```
 
 ## 快速开始
@@ -95,7 +118,9 @@ codexmate status
 codexmate run
 ```
 
-默认监听 `127.0.0.1:3737`，并尝试自动打开浏览器。
+默认监听 `0.0.0.0:3737`，支持局域网访问，并尝试自动打开浏览器。
+
+> 安全提示：默认监听会在当前局域网暴露未鉴权的管理界面。若包含 API Key、provider 配置或 skills 管理，请仅在可信网络中使用；如需仅本机访问，可设置 `CODEXMATE_HOST=127.0.0.1` 或启动时传入 `--host 127.0.0.1`。
 
 ### 从源码运行
 
@@ -103,14 +128,13 @@ codexmate run
 git clone https://github.com/SakuraByteCore/codexmate.git
 cd codexmate
 npm install
-npm link
-codexmate run
+npm start run
 ```
 
 ### 测试 / CI（只启动服务）
 
 ```bash
-codexmate run --no-browser
+npm start run --no-browser
 ```
 
 > 约定：自动化测试仅验证服务与 API，不依赖打开页面。
@@ -126,8 +150,6 @@ codexmate run --no-browser
 | `codexmate add <name> <URL> [API_KEY]` | 添加提供商 |
 | `codexmate delete <name>` | 删除提供商 |
 | `codexmate claude <BaseURL> <API_KEY> [model]` | 写入 Claude Code 配置 |
-| `codexmate auth <list\|import\|switch\|delete\|status>` | 认证档案管理 |
-| `codexmate proxy <status\|set\|apply\|enable\|start\|stop>` | 内建代理管理 |
 | `codexmate workflow <list\|get\|validate\|run\|runs>` | MCP 工作流管理 |
 | `codexmate codex [args...] [--follow-up <文本> 可重复]` | Codex CLI 透传入口（默认补 `--yolo`，可追加 queued follow-up） |
 | `codexmate qwen [args...]` | Qwen CLI 透传入口 |
@@ -152,8 +174,6 @@ codexmate codex --model gpt-5.3-codex --follow-up "步骤1" --follow-up "步骤2
 - provider / model 切换
 - 模型管理
 - `~/.codex/AGENTS.md` 编辑
-- `~/.codex/skills` 管理（筛选、批量删除、跨应用导入）
-
 
 ### Claude Code 配置模式
 - 多配置方案管理
@@ -167,8 +187,15 @@ codexmate codex --model gpt-5.3-codex --follow-up "步骤1" --follow-up "步骤2
 
 ### 会话模式
 - Codex + Claude 会话统一列表
+- 支持本地会话置顶、持久化保存与置顶优先排序
 - 搜索、筛选、导出、删除、批量清理
 
+### Skills 市场标签页
+- 在 `Codex` 与 `Claude Code` 之间切换 skills 安装目标
+- 展示当前目标的本地 skills 根目录、已安装项和可导入项
+- 扫描 `Codex` / `Claude Code` / `Agents` 目录中的可导入来源
+- 支持跨应用导入、ZIP 导入 / 导出、批量删除
+
 ## MCP
 
 > 传输：`stdio`
@@ -200,7 +227,7 @@ codexmate mcp serve --allow-write
 | 变量 | 默认值 | 说明 |
 | --- | --- | --- |
 | `CODEXMATE_PORT` | `3737` | Web 服务端口 |
-| `CODEXMATE_HOST` | `127.0.0.1` | Web 服务监听地址 |
+| `CODEXMATE_HOST` | `0.0.0.0` | Web 服务监听地址（如需仅本机访问，显式设为 `127.0.0.1`） |
 | `CODEXMATE_NO_BROWSER` | 未设置 | 设为 `1` 后不自动打开浏览器 |
 | `CODEXMATE_MCP_ALLOW_WRITE` | 未设置 | 设为 `1` 后默认允许 MCP 写工具 |
 | `CODEXMATE_FORCE_RESET_EXISTING_CONFIG` | `0` | 设为 `1` 时首次可强制重建托管配置 |
@@ -214,10 +241,7 @@ codexmate mcp serve --allow-write
 
 ## 参与贡献
 
-欢迎提交 Issue 和 Pull Request。
-
-- 英文更新日志：`doc/CHANGELOG.md`
-- 中文更新日志：`doc/CHANGELOG.zh-CN.md`
+Issue 与 Pull Request 可按需提交。
 
 ## License