codexmate 0.0.40 → 0.0.41

package/README.md

@@ -1,156 +1,168 @@
-<div align="center">
-
-<img src="site/.vitepress/public/images/logo.png" alt="Codex Mate logo" width="160" />
-
-# Codex Mate
-
-**One dashboard for all your local AI coding agents. Switch providers, manage sessions, and orchestrate tasks across Codex, Claude Code, and OpenClaw. Zero cloud, local-first control plane.**
-
-<p>
-  <a href="https://sakurabytecore.github.io/codexmate/">[Documentation]</a>
-  <a href="#quick-start">[Quick Start]</a>
-  <a href="README.zh.md">[简体中文]</a>
-</p>
-
-[![Version](https://img.shields.io/npm/v/codexmate?style=flat-square&color=A179FF)](https://www.npmjs.com/package/codexmate)
-[![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?style=flat-square&color=44cc11)](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
-[![Downloads](https://img.shields.io/npm/dt/codexmate?style=flat-square)](https://www.npmjs.com/package/codexmate)
-[![Install](https://img.shields.io/badge/install-brew%20%7C%20curl%20%7C%20npm-0A0?style=flat-square)](#install-via-homebrew-macos--linux)
-[![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux%20%7C%20macOS%20%7C%20Windows-555?style=flat-square)](#quick-start)
-[![Node](https://img.shields.io/node/v/codexmate?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/)
-[![License](https://img.shields.io/npm/l/codexmate?style=flat-square)](LICENSE)
-[![Stars](https://img.shields.io/github/stars/SakuraByteCore/codexmate?style=flat-square&color=gold)](https://github.com/SakuraByteCore/codexmate/stargazers)
-[![Issues](https://img.shields.io/github/issues/SakuraByteCore/codexmate?style=flat-square&color=ff69b4)](https://github.com/SakuraByteCore/codexmate/issues)
-
-<br />
-
-<img src="site/.vitepress/public/images/readme-hero.png" alt="Codex Mate screenshot" width="100%" />
-
-</div>
-
----
-
-> [!TIP]
-> **Local First**: All configurations and sessions are stored in your home directory. No telemetry, no cloud accounts required.
-
-> [!IMPORTANT]
-> This project is currently in early stage. We are seeking developers to help build the local agent ecosystem!
-
-## What is Codex Mate?
-
-Have you ever felt overwhelmed by managing multiple local AI agents? Each has its own config format, session storage, and skills directory.
-
-**Codex Mate** offers a unified control plane to bring order to the chaos. It's a local-first CLI + Web UI designed to manage [Codex](https://github.com/openai/codex)、[Claude Code](https://github.com/anthropic-ai/claude-code) and [OpenClaw](https://github.com/moeru-ai/openclaw) seamlessly.
-
-### What's So Special?
-
-Unlike simple wrappers, Codex Mate acts as a **Local Agent Bridge**:
-- **Unified Session Browser**: Search and export sessions across all tools in one place.
-- **OpenAI-Compatible Bridge**: Use Codex with any OpenAI-compatible UI by normalizing the Responses API.
-- **Skills Marketplace**: A local-first market to share and import skills between different agent apps.
-- **Task Orchestrator**: Plan and execute complex tasks with dependency tracking.
-
----
-
-## Current Progress
-
-| Feature | Status | Description |
-| --- | --- | --- |
-| **Provider Management** | ✅ | Switch providers/models for Codex, Claude, and OpenClaw |
-| **Live Agent Sync** | ✅ | Real-time monitoring of Codex/Claude config & status |
-| **Session Browser** | ✅ | List, filter, and export sessions (Codex/Claude/Gemini) |
-| **Usage Analytics** | ✅ | Visualize message trends and top projects |
-| **Local Skills Market** | ✅ | Cross-app import/export of agent skills |
-| **Task Queue** | ✅ | DAG-based task execution and logs |
-| **OpenAI Bridge** | ✅ | Convert Codex Responses API to standard OpenAI format |
-| **Prompt Templates** | ✅ | Reusable prompt plugins with variables |
-| **MCP Integration** | ✅ | Expose local tools and resources via MCP stdio |
-| **Auto Update** | ✅ | Quick update CLI via `codexmate update` |
-
----
-
-## Quick Start
-
-### Install via Homebrew (macOS / Linux)
-
-```bash
-brew tap SakuraByteCore/codexmate
-brew install codexmate
-```
-
-Requires [Node.js](https://nodejs.org/) (`brew install node` if not present).
-
-### Install via npm
-
-```bash
-npm install -g codexmate
-codexmate run
-```
-
-### Install via curl (Standalone)
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/SakuraByteCore/codexmate/main/scripts/install.sh | bash
-```
-
-### Supported Agents
-
-- **Codex**: `npm install -g @openai/codex`
-- **Claude Code**: `npm install -g @anthropic-ai/claude-code`
-- **Gemini CLI**: `npm install -g @google/gemini-cli`
-- **CodeBuddy**: `npm install -g @tencent-ai/codebuddy-code`
-
----
-
-## Architecture
-
-```mermaid
-%%{ init: { 'flowchart': { 'curve': 'catmullRom' } } }%%
-flowchart TD
-    User([User])
-    CLI[CLI]
-    WebUI[Web UI]
-    MCP[MCP Server]
-
-    subgraph Mate [Codex Mate Core]
-        API[HTTP API]
-        Config[Config Engine]
-        Session[Session Manager]
-        Skills[Skills Market]
-        Tasks[Task Runner]
-    end
-
-    subgraph Local [Local Filesystem]
-        CodexDir[~/.codex]
-        ClaudeDir[~/.claude]
-        ClawDir[~/.openclaw]
-        State[Sessions/Usage/Trash]
-    end
-
-    User --> CLI & WebUI & MCP
-    CLI & WebUI & MCP --> API
-
-    API --> Config & Session & Skills & Tasks
-
-    Config --> CodexDir & ClaudeDir & ClawDir
-    Session --> State
-    Skills --> Local
-```
-
----
-
-## Special Thanks
-
-Special thanks to all contributors for their contributions to Codex Mate ❤️
-
-<a href="https://github.com/SakuraByteCore/codexmate/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=SakuraByteCore/codexmate" />
-</a>
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=SakuraByteCore/codexmate&type=Date)](https://star-history.com/#SakuraByteCore/codexmate&Date)
-
-## License
-
-Apache-2.0
+<div align="center">
+
+<img src="site/.vitepress/public/images/logo.png" alt="Codex Mate logo" width="160" />
+
+# Codex Mate
+
+**One dashboard for all your local AI coding agents. Switch providers, manage sessions, and orchestrate tasks across Codex, Claude Code, and OpenClaw. Zero cloud, local-first control plane.**
+
+<p>
+  <a href="https://sakurabytecore.github.io/codexmate/">[Documentation]</a>
+  <a href="#quick-start">[Quick Start]</a>
+  <a href="README.zh.md">[简体中文]</a>
+</p>
+
+[![Version](https://img.shields.io/npm/v/codexmate?style=flat-square&color=A179FF)](https://www.npmjs.com/package/codexmate)
+[![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?style=flat-square&color=44cc11)](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
+[![Downloads](https://img.shields.io/npm/dt/codexmate?style=flat-square)](https://www.npmjs.com/package/codexmate)
+[![Install](https://img.shields.io/badge/install-brew%20%7C%20curl%20%7C%20npm-0A0?style=flat-square)](#install-via-homebrew-macos--linux)
+[![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux%20%7C%20macOS%20%7C%20Windows-555?style=flat-square)](#quick-start)
+[![Node](https://img.shields.io/node/v/codexmate?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/)
+[![License](https://img.shields.io/npm/l/codexmate?style=flat-square)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/SakuraByteCore/codexmate?style=flat-square&color=gold)](https://github.com/SakuraByteCore/codexmate/stargazers)
+[![Issues](https://img.shields.io/github/issues/SakuraByteCore/codexmate?style=flat-square&color=ff69b4)](https://github.com/SakuraByteCore/codexmate/issues)
+
+<br />
+
+<img src="site/.vitepress/public/images/readme-hero.png" alt="Codex Mate screenshot" width="100%" />
+
+</div>
+
+---
+
+> [!TIP]
+> **Local First**: All configurations and sessions are stored in your home directory. No telemetry, no cloud accounts required.
+
+> [!IMPORTANT]
+> This project is currently in early stage. We are seeking developers to help build the local agent ecosystem!
+
+## What is Codex Mate?
+
+Have you ever felt overwhelmed by managing multiple local AI agents? Each has its own config format, session storage, and skills directory.
+
+**Codex Mate** offers a unified control plane to bring order to the chaos. It's a local-first CLI + Web UI designed to manage [Codex](https://github.com/openai/codex)、[Claude Code](https://github.com/anthropic-ai/claude-code) and [OpenClaw](https://github.com/moeru-ai/openclaw) seamlessly.
+
+### What's So Special?
+
+Unlike simple wrappers, Codex Mate acts as a **Local Agent Bridge**:
+- **Unified Session Browser**: Search and export sessions across all tools in one place.
+- **OpenAI-Compatible Bridge**: Use Codex with any OpenAI-compatible UI by normalizing the Responses API.
+- **Skills Marketplace**: A local-first market to share and import skills between different agent apps.
+- **Task Orchestrator**: Plan and execute complex tasks with dependency tracking.
+
+---
+
+## Current Progress
+
+| Feature | Status | Description |
+| --- | --- | --- |
+| **Provider Management** | ✅ | Switch providers/models for Codex, Claude, and OpenClaw |
+| **Live Agent Sync** | ✅ | Real-time monitoring of Codex/Claude config & status |
+| **Session Browser** | ✅ | List, filter, and export sessions (Codex/Claude/Gemini) |
+| **Usage Analytics** | ✅ | Visualize message trends and top projects |
+| **Local Skills Market** | ✅ | Cross-app import/export of agent skills |
+| **Task Queue** | ✅ | DAG-based task execution and logs |
+| **OpenAI Bridge** | ✅ | Convert Codex Responses API to standard OpenAI format |
+| **Prompt Templates** | ✅ | Reusable prompt plugins with variables |
+| **MCP Integration** | ✅ | Expose local tools and resources via MCP stdio |
+| **Auto Update** | ✅ | Quick update CLI via `codexmate update` |
+
+---
+
+## Quick Start
+
+### Install via Homebrew (macOS / Linux)
+
+```bash
+brew tap SakuraByteCore/codexmate
+brew install codexmate
+```
+
+Requires [Node.js](https://nodejs.org/) (`brew install node` if not present).
+
+### Install via npm
+
+```bash
+npm install -g codexmate
+codexmate run
+```
+
+If the default Web UI port `3737` is unavailable, Codex Mate automatically tries the next ports (`3738`, `3739`, ...). To force a fixed port, set `CODEXMATE_PORT`:
+
+```bash
+CODEXMATE_PORT=8080 codexmate run
+```
+
+Windows PowerShell:
+
+```powershell
+$env:CODEXMATE_PORT=8080; codexmate run
+```
+
+### Install via curl (Standalone)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/SakuraByteCore/codexmate/main/scripts/install.sh | bash
+```
+
+### Supported Agents
+
+- **Codex**: `npm install -g @openai/codex`
+- **Claude Code**: `npm install -g @anthropic-ai/claude-code`
+- **Gemini CLI**: `npm install -g @google/gemini-cli`
+- **CodeBuddy**: `npm install -g @tencent-ai/codebuddy-code`
+
+---
+
+## Architecture
+
+```mermaid
+%%{ init: { 'flowchart': { 'curve': 'catmullRom' } } }%%
+flowchart TD
+    User([User])
+    CLI[CLI]
+    WebUI[Web UI]
+    MCP[MCP Server]
+
+    subgraph Mate [Codex Mate Core]
+        API[HTTP API]
+        Config[Config Engine]
+        Session[Session Manager]
+        Skills[Skills Market]
+        Tasks[Task Runner]
+    end
+
+    subgraph Local [Local Filesystem]
+        CodexDir[~/.codex]
+        ClaudeDir[~/.claude]
+        ClawDir[~/.openclaw]
+        State[Sessions/Usage/Trash]
+    end
+
+    User --> CLI & WebUI & MCP
+    CLI & WebUI & MCP --> API
+
+    API --> Config & Session & Skills & Tasks
+
+    Config --> CodexDir & ClaudeDir & ClawDir
+    Session --> State
+    Skills --> Local
+```
+
+---
+
+## Special Thanks
+
+Special thanks to all contributors for their contributions to Codex Mate ❤️
+
+<a href="https://github.com/SakuraByteCore/codexmate/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=SakuraByteCore/codexmate" />
+</a>
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=SakuraByteCore/codexmate&type=Date)](https://star-history.com/#SakuraByteCore/codexmate&Date)
+
+## License
+
+Apache-2.0

package/README.zh.md

@@ -1,156 +1,168 @@
-<div align="center">
-
-<img src="site/.vitepress/public/images/logo.png" alt="Codex Mate logo" width="160" />
-
-# Codex Mate
-
-**一站式本地 AI 编程智能体管理面板。统一管理 Codex、Claude Code 与 OpenClaw，支持 Provider 切换、会话管理与任务编排。纯本地优先，你的智能体控制中心。**
-
-<p>
-  <a href="https://sakurabytecore.github.io/codexmate/">[项目文档]</a>
-  <a href="#快速开始">[快速开始]</a>
-  <a href="README.md">[English]</a>
-</p>
-
-[![Version](https://img.shields.io/npm/v/codexmate?style=flat-square&color=A179FF)](https://www.npmjs.com/package/codexmate)
-[![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?style=flat-square&color=44cc11)](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
-[![Downloads](https://img.shields.io/npm/dt/codexmate?style=flat-square)](https://www.npmjs.com/package/codexmate)
-[![Install](https://img.shields.io/badge/install-brew%20%7C%20curl%20%7C%20npm-0A0?style=flat-square)](#homebrew-安装macos--linux)
-[![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux%20%7C%20macOS%20%7C%20Windows-555?style=flat-square)](#快速开始)
-[![Node](https://img.shields.io/node/v/codexmate?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/)
-[![License](https://img.shields.io/npm/l/codexmate?style=flat-square)](LICENSE)
-[![Stars](https://img.shields.io/github/stars/SakuraByteCore/codexmate?style=flat-square&color=gold)](https://github.com/SakuraByteCore/codexmate/stargazers)
-[![Issues](https://img.shields.io/github/issues/SakuraByteCore/codexmate?style=flat-square&color=ff69b4)](https://github.com/SakuraByteCore/codexmate/issues)
-
-<br />
-
-<img src="site/.vitepress/public/images/readme-hero.png" alt="Codex Mate 界面预览" width="100%" />
-
-</div>
-
----
-
-> [!TIP]
-> **本地优先**：所有配置和会话均存储在您的主目录中。无需遥测，无需云端账户。
-
-> [!IMPORTANT]
-> 本项目目前处于早期开发阶段。我们正在寻找开发者共同构建本地智能体生态！
-
-## 什么是 Codex Mate?
-
-你是否曾因管理多个本地 AI 智能体而感到疲惫？每个工具都有自己的配置格式、会话存储和 Skills 目录。
-
-**Codex Mate** 提供了一个统一的控制平面，让混乱重归有序。这是一个本地优先的 CLI + Web UI，旨在无缝管理 [Codex](https://github.com/openai/codex)、[Claude Code](https://github.com/anthropic-ai/claude-code) 和 [OpenClaw](https://github.com/moeru-ai/openclaw)。
-
-### 有什么独特之处？
-
-不同于简单的封装，Codex Mate 充当了 **本地智能体桥接器**：
-- **统一会话浏览器**：在一个地方搜索并导出所有工具的会话。
-- **OpenAI 兼容桥接**：通过归一化 Responses API，让 Codex 能够与任何支持 OpenAI 格式的 UI 配合使用。
-- **Skills 市场**：本地优先的市场，支持在不同的智能体应用之间共享和导入 Skills。
-- **任务编排器**：支持带有依赖跟踪的复杂任务规划与执行。
-
----
-
-## 当前进展
-
-| 特性 | 状态 | 描述 |
-| --- | --- | --- |
-| **Provider 管理** | ✅ | 切换 Codex、Claude 和 OpenClaw 的 provider/model |
-| **状态实时同步** | ✅ | 实时感知 Codex/Claude 的配置与运行状态变更 |
-| **会话浏览器** | ✅ | 列表、筛选及导出会话 (Codex/Claude/Gemini) |
-| **Usage 统计** | ✅ | 可视化消息趋势与热门项目统计 |
-| **本地 Skills 市场** | ✅ | 跨应用的智能体 Skills 导入与导出 |
-| **任务队列** | ✅ | 基于 DAG 的任务执行与日志查看 |
-| **OpenAI 桥接** | ✅ | 将 Codex Responses API 转换为标准 OpenAI 格式 |
-| **提示词模板** | ✅ | 支持变量的可复用提示词插件 |
-| **MCP 集成** | ✅ | 通过 MCP stdio 暴露本地工具与资源 |
-| **自动更新** | ✅ | 通过 `codexmate update` 快速更新 CLI |
-
----
-
-## 快速开始
-
-### Homebrew 安装（macOS / Linux）
-
-```bash
-brew tap SakuraByteCore/codexmate
-brew install codexmate
-```
-
-需要 [Node.js](https://nodejs.org/)（如未安装可执行 `brew install node`）。
-
-### 通过 npm 安装
-
-```bash
-npm install -g codexmate
-codexmate run
-```
-
-### 通过 curl 安装 (独立包)
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/SakuraByteCore/codexmate/main/scripts/install.sh | bash
-```
-
-### 支持的智能体
-
-- **Codex**: `npm install -g @openai/codex`
-- **Claude Code**: `npm install -g @anthropic-ai/claude-code`
-- **Gemini CLI**: `npm install -g @google/gemini-cli`
-- **CodeBuddy**: `npm install -g @tencent-ai/codebuddy-code`
-
----
-
-## 架构总览
-
-```mermaid
-%%{ init: { 'flowchart': { 'curve': 'catmullRom' } } }%%
-flowchart TD
-    User([用户])
-    CLI[CLI 命令]
-    WebUI[Web 界面]
-    MCP[MCP 服务]
-
-    subgraph Mate [Codex Mate 核心]
-        API[HTTP API]
-        Config[配置引擎]
-        Session[会话管理器]
-        Skills[Skills 市场]
-        Tasks[任务运行器]
-    end
-
-    subgraph Local [本地文件系统]
-        CodexDir[~/.codex]
-        ClaudeDir[~/.claude]
-        ClawDir[~/.openclaw]
-        State[会话/Usage/回收站]
-    end
-
-    User --> CLI & WebUI & MCP
-    CLI & WebUI & MCP --> API
-
-    API --> Config & Session & Skills & Tasks
-
-    Config --> CodexDir & ClaudeDir & ClawDir
-    Session --> State
-    Skills --> Local
-```
-
----
-
-## 特别鸣谢
-
-感谢所有贡献者对 Codex Mate 的辛勤付出 ❤️
-
-<a href="https://github.com/SakuraByteCore/codexmate/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=SakuraByteCore/codexmate" />
-</a>
-
-## Star 历史
-
-[![Star History Chart](https://api.star-history.com/svg?repos=SakuraByteCore/codexmate&type=Date)](https://star-history.com/#SakuraByteCore/codexmate&Date)
-
-## 开源协议
-
-Apache-2.0
+<div align="center">
+
+<img src="site/.vitepress/public/images/logo.png" alt="Codex Mate logo" width="160" />
+
+# Codex Mate
+
+**一站式本地 AI 编程智能体管理面板。统一管理 Codex、Claude Code 与 OpenClaw，支持 Provider 切换、会话管理与任务编排。纯本地优先，你的智能体控制中心。**
+
+<p>
+  <a href="https://sakurabytecore.github.io/codexmate/">[项目文档]</a>
+  <a href="#快速开始">[快速开始]</a>
+  <a href="README.md">[English]</a>
+</p>
+
+[![Version](https://img.shields.io/npm/v/codexmate?style=flat-square&color=A179FF)](https://www.npmjs.com/package/codexmate)
+[![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?style=flat-square&color=44cc11)](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
+[![Downloads](https://img.shields.io/npm/dt/codexmate?style=flat-square)](https://www.npmjs.com/package/codexmate)
+[![Install](https://img.shields.io/badge/install-brew%20%7C%20curl%20%7C%20npm-0A0?style=flat-square)](#homebrew-安装macos--linux)
+[![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux%20%7C%20macOS%20%7C%20Windows-555?style=flat-square)](#快速开始)
+[![Node](https://img.shields.io/node/v/codexmate?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org/)
+[![License](https://img.shields.io/npm/l/codexmate?style=flat-square)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/SakuraByteCore/codexmate?style=flat-square&color=gold)](https://github.com/SakuraByteCore/codexmate/stargazers)
+[![Issues](https://img.shields.io/github/issues/SakuraByteCore/codexmate?style=flat-square&color=ff69b4)](https://github.com/SakuraByteCore/codexmate/issues)
+
+<br />
+
+<img src="site/.vitepress/public/images/readme-hero.png" alt="Codex Mate 界面预览" width="100%" />
+
+</div>
+
+---
+
+> [!TIP]
+> **本地优先**：所有配置和会话均存储在您的主目录中。无需遥测，无需云端账户。
+
+> [!IMPORTANT]
+> 本项目目前处于早期开发阶段。我们正在寻找开发者共同构建本地智能体生态！
+
+## 什么是 Codex Mate?
+
+你是否曾因管理多个本地 AI 智能体而感到疲惫？每个工具都有自己的配置格式、会话存储和 Skills 目录。
+
+**Codex Mate** 提供了一个统一的控制平面，让混乱重归有序。这是一个本地优先的 CLI + Web UI，旨在无缝管理 [Codex](https://github.com/openai/codex)、[Claude Code](https://github.com/anthropic-ai/claude-code) 和 [OpenClaw](https://github.com/moeru-ai/openclaw)。
+
+### 有什么独特之处？
+
+不同于简单的封装，Codex Mate 充当了 **本地智能体桥接器**：
+- **统一会话浏览器**：在一个地方搜索并导出所有工具的会话。
+- **OpenAI 兼容桥接**：通过归一化 Responses API，让 Codex 能够与任何支持 OpenAI 格式的 UI 配合使用。
+- **Skills 市场**：本地优先的市场，支持在不同的智能体应用之间共享和导入 Skills。
+- **任务编排器**：支持带有依赖跟踪的复杂任务规划与执行。
+
+---
+
+## 当前进展
+
+| 特性 | 状态 | 描述 |
+| --- | --- | --- |
+| **Provider 管理** | ✅ | 切换 Codex、Claude 和 OpenClaw 的 provider/model |
+| **状态实时同步** | ✅ | 实时感知 Codex/Claude 的配置与运行状态变更 |
+| **会话浏览器** | ✅ | 列表、筛选及导出会话 (Codex/Claude/Gemini) |
+| **Usage 统计** | ✅ | 可视化消息趋势与热门项目统计 |
+| **本地 Skills 市场** | ✅ | 跨应用的智能体 Skills 导入与导出 |
+| **任务队列** | ✅ | 基于 DAG 的任务执行与日志查看 |
+| **OpenAI 桥接** | ✅ | 将 Codex Responses API 转换为标准 OpenAI 格式 |
+| **提示词模板** | ✅ | 支持变量的可复用提示词插件 |
+| **MCP 集成** | ✅ | 通过 MCP stdio 暴露本地工具与资源 |
+| **自动更新** | ✅ | 通过 `codexmate update` 快速更新 CLI |
+
+---
+
+## 快速开始
+
+### Homebrew 安装（macOS / Linux）
+
+```bash
+brew tap SakuraByteCore/codexmate
+brew install codexmate
+```
+
+需要 [Node.js](https://nodejs.org/)（如未安装可执行 `brew install node`）。
+
+### 通过 npm 安装
+
+```bash
+npm install -g codexmate
+codexmate run
+```
+
+如果默认 Web UI 端口 `3737` 不可用，Codex Mate 会自动尝试后续端口（`3738`、`3739` ...）。如需固定端口，可以指定 `CODEXMATE_PORT`：
+
+```bash
+CODEXMATE_PORT=8080 codexmate run
+```
+
+Windows PowerShell：
+
+```powershell
+$env:CODEXMATE_PORT=8080; codexmate run
+```
+
+### 通过 curl 安装 (独立包)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/SakuraByteCore/codexmate/main/scripts/install.sh | bash
+```
+
+### 支持的智能体
+
+- **Codex**: `npm install -g @openai/codex`
+- **Claude Code**: `npm install -g @anthropic-ai/claude-code`
+- **Gemini CLI**: `npm install -g @google/gemini-cli`
+- **CodeBuddy**: `npm install -g @tencent-ai/codebuddy-code`
+
+---
+
+## 架构总览
+
+```mermaid
+%%{ init: { 'flowchart': { 'curve': 'catmullRom' } } }%%
+flowchart TD
+    User([用户])
+    CLI[CLI 命令]
+    WebUI[Web 界面]
+    MCP[MCP 服务]
+
+    subgraph Mate [Codex Mate 核心]
+        API[HTTP API]
+        Config[配置引擎]
+        Session[会话管理器]
+        Skills[Skills 市场]
+        Tasks[任务运行器]
+    end
+
+    subgraph Local [本地文件系统]
+        CodexDir[~/.codex]
+        ClaudeDir[~/.claude]
+        ClawDir[~/.openclaw]
+        State[会话/Usage/回收站]
+    end
+
+    User --> CLI & WebUI & MCP
+    CLI & WebUI & MCP --> API
+
+    API --> Config & Session & Skills & Tasks
+
+    Config --> CodexDir & ClaudeDir & ClawDir
+    Session --> State
+    Skills --> Local
+```
+
+---
+
+## 特别鸣谢
+
+感谢所有贡献者对 Codex Mate 的辛勤付出 ❤️
+
+<a href="https://github.com/SakuraByteCore/codexmate/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=SakuraByteCore/codexmate" />
+</a>
+
+## Star 历史
+
+[![Star History Chart](https://api.star-history.com/svg?repos=SakuraByteCore/codexmate&type=Date)](https://star-history.com/#SakuraByteCore/codexmate&Date)
+
+## 开源协议
+
+Apache-2.0