codexmate 0.0.17 → 0.0.18

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)
@@ -50,6 +47,7 @@ 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)
@@ -63,25 +61,46 @@ 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 / Workflow"]
+      CORE["File IO / Network / Diff / Session Utils"]
+    end
+
+    subgraph Data["Local Files"]
+      CODEX["~/.codex"]
+      CLAUDE["~/.claude"]
+      OPENCLAW["~/.openclaw"]
+      STATE["sessions / trash / workflow runs"]
     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 --> STATE
 ```
 
 ## Quick Start
@@ -103,14 +122,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.
@@ -167,6 +185,7 @@ 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
 
 ## MCP

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)
@@ -50,6 +47,7 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 
 **会话管理**
 - 同页查看 Codex 与 Claude 会话
+- 支持本地会话置顶，置顶状态持久化保存并优先排序显示
 - 关键词搜索、来源筛选、cwd 路径筛选
 - 会话导出 Markdown
 - 会话与消息级删除（支持批量）
@@ -63,25 +61,46 @@ Codex Mate 提供一套本地优先的 CLI + Web UI，用于统一管理：
 ## 架构总览
 
 ```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"]
+      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 / Workflow"]
+      CORE["File IO / Network / Diff / Session Utils"]
+    end
+
+    subgraph State["Local State"]
+      CODEX["~/.codex"]
+      CLAUDE["~/.claude"]
+      OPENCLAW["~/.openclaw"]
+      STATE["sessions / trash / workflow runs"]
     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 --> STATE
 ```
 
 ## 快速开始
@@ -103,14 +122,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，不依赖打开页面。
@@ -167,6 +185,7 @@ codexmate codex --model gpt-5.3-codex --follow-up "步骤1" --follow-up "步骤2
 
 ### 会话模式
 - Codex + Claude 会话统一列表
+- 支持本地会话置顶、持久化保存与置顶优先排序
 - 搜索、筛选、导出、删除、批量清理
 
 ## MCP