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.

[Documentation] [Quick Start] [简体中文]

---

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、Claude Code and 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 npm

npm install -g codexmate
codexmate setup
codexmate run

Install via curl (Standalone)

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

%%{ 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

Loading

---

Special Thanks

Special thanks to all contributors for their contributions to Codex Mate ❤️

Star History

License

Apache-2.0