Skip to content

README.vi.md

Latest commit

 

History

History
176 lines (126 loc) · 7.83 KB

README.vi.md

File metadata and controls

176 lines (126 loc) · 7.83 KB
Raw
Codex Mate logo

Codex Mate

Một dashboard duy nhất cho tất cả AI coding agent cục bộ của bạn. Chuyển đổi provider, quản lý phiên làm việc và điều phối tác vụ giữa Codex, Claude Code, Gemini CLI, CodeBuddy Code, Pi, OpenCode, KiloCode và OpenClaw. Không cloud, trung tâm điều khiển agent hoàn toàn cục bộ.

[Tài liệu] [Bắt đầu nhanh] [English] [简体中文]

Version Build Downloads Install Platform Node License Stars Issues


Giao diện Codex Mate

Tip

Ưu tiên cục bộ: Toàn bộ cấu hình và phiên làm việc được lưu trong thư mục home của bạn. Không có telemetry, không cần tài khoản cloud.

Important

Dự án đang ở giai đoạn đầu. Chúng tôi đang tìm kiếm các nhà phát triển để cùng xây dựng hệ sinh thái agent cục bộ!

Codex Mate là gì?

Bạn có bao giờ cảm thấy rối khi phải quản lý nhiều AI agent cục bộ? Mỗi tool lại có định dạng cấu hình, nơi lưu phiên và thư mục skill riêng.

Codex Mate cung cấp một trung tâm điều khiển thống nhất để giải quyết sự hỗn loạn đó. Đây là CLI + Web UI ưu tiên cục bộ, được thiết kế để quản lý Codex, Claude Code, OpenCode, KiloCode và OpenClaw một cách liền mạch.

Điểm nổi bật

Khác với các wrapper đơn giản, Codex Mate hoạt động như một Agent Bridge cục bộ:

  • Trình duyệt phiên thống nhất: Tìm kiếm, xem trước, lọc và xuất phiên làm việc từ Codex, Claude Code, Gemini CLI, CodeBuddy Code và Pi trong một nơi duy nhất.
  • Bridge tương thích OpenAI: Dùng Codex với bất kỳ UI nào hỗ trợ OpenAI bằng cách chuẩn hóa Responses API.
  • Dọn dẹp provider lỗi: Kiểm tra route provider cục bộ của Codex/Claude, hiển thị cấu hình lỗi trong một modal và xóa hàng loạt các provider hỏng đã chọn mà không chạm vào mục khỏe mạnh hoặc được bảo vệ.
  • Chợ skill cục bộ: Chia sẻ và nhập skill giữa các app agent khác nhau.
  • Điều phối tác vụ: Lập kế hoạch và thực thi tác vụ phức tạp với theo dõi phụ thuộc.

Tiến độ hiện tại

Tính năng Trạng thái Mô tả
Quản lý Provider ✅ Chuyển đổi provider/model cho Codex, Claude, OpenCode, KiloCode và OpenClaw
Đồng bộ Agent trực tiếp ✅ Giám sát cấu hình & trạng thái Codex/Claude theo thời gian thực
Trình duyệt phiên ✅ Liệt kê, xem trước, lọc và xuất phiên (Codex/Claude/Gemini/CodeBuddy/Pi)
Phân tích sử dụng ✅ Trực quan hóa xu hướng tin nhắn và dự án nổi bật
Chợ skill cục bộ ✅ Import/export skill giữa các app agent
Hàng đợi tác vụ ✅ Thực thi tác vụ theo DAG và xem log
Bridge OpenAI ✅ Chuyển đổi Codex Responses API sang định dạng OpenAI chuẩn
Kiểm tra sức khỏe Provider ✅ Kiểm tra route provider Codex/Claude, đánh dấu cấu hình lỗi và xóa hàng loạt các provider hỏng đã chọn một cách an toàn
Mẫu Prompt ✅ Plugin prompt tái sử dụng được với hỗ trợ biến
Trình sửa tệp prompt ✅ Chỉnh sửa CLAUDE.md / AGENTS.md và dùng kho preset chung. Áp dụng preset chỉ cập nhật editor; cần lưu thủ công để ghi vào tệp.
Tích hợp MCP ✅ Expose tool và resource cục bộ qua MCP stdio
Tự động cập nhật ✅ Cập nhật nhanh qua codexmate update

Bắt đầu nhanh

Cài đặt qua Homebrew (macOS / Linux)

brew tap SakuraByteCore/codexmate
brew install codexmate

Yêu cầu Node.js (brew install node nếu chưa có).

Cài đặt qua npm

npm install -g codexmate
codexmate run

Nếu cổng mặc định 3737 bận, Codex Mate tự động thử cổng kế tiếp (3738, 3739, ...). Để chỉ định cổng cố định:

CODEXMATE_PORT=8080 codexmate run

Windows PowerShell:

$env:CODEXMATE_PORT=8080; codexmate run

Cài đặt qua curl (Standalone)

curl -fsSL https://raw.githubusercontent.com/SakuraByteCore/codexmate/main/scripts/install.sh | bash

Agent được hỗ trợ

  • 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
  • KiloCode: npm install -g @kilocode/cli (kilo / kilocode)
  • OpenCode: xem tài liệu chính thức OpenCode
  • OpenClaw: xem kho lưu trữ OpenClaw
  • Pi: phiên làm việc được phát hiện từ ~/.pi/agent/sessions

Kiến trúc

%%{ init: { 'flowchart': { 'curve': 'catmullRom' } } }%%
flowchart TD
    User([Người dùng])
    CLI[CLI]
    WebUI[Web UI]
    MCP[MCP Server]

    subgraph Mate [Codex Mate Core]
        API[HTTP API]
        Config[Config Engine]
        Session[Quản lý phiên]
        Skills[Chợ Skill]
        Tasks[Thực thi tác vụ]
    end

    subgraph Local [Hệ thống tệp cục bộ]
        CodexDir[~/.codex]
        ClaudeDir[~/.claude]
        ClawDir[~/.openclaw]
        State[Phiên/Sử dụng/Thùng rác]
    end

    User --> CLI & WebUI & MCP
    CLI & WebUI & MCP --> API

    API --> Config & Session & Skills & Tasks

    Config --> CodexDir & ClaudeDir & ClawDir
    Session --> State
    Skills --> Local
Loading

Lời cảm ơn

Cảm ơn tất cả những người đóng góp cho Codex Mate ❤️

Contributors

Lịch sử Star

Star History Chart

Giấy phép

Apache-2.0