codexmate

Name: codexmate
Author: SakuraByteCore

Verified

One dashboard for all your local AI coding agents. Switch providers, manage sessions, and orchestrate tasks across Codex, Claude Code, OpenCode, and OpenClaw. Zero cloud, local-first control plane.

322stars

33forks

JavaScript

Installation

# Add to your Claude Code skills
git clone https://github.com/SakuraByteCore/codexmate

Getting Started

Guides for using ai agents skills like codexmate.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/31/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "esbuild: esbuild enables any website to send any requests to the development server and read the response",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "vite: Vite Vulnerable to Path Traversal in Optimized Deps `.map` Handling",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "vitepress: Vulnerability found",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-05-31T07:45:47.843Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is codexmate?

codexmate is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by SakuraByteCore. One dashboard for all your local AI coding agents. Switch providers, manage sessions, and orchestrate tasks across Codex, Claude Code, OpenCode, and OpenClaw. Zero cloud, local-first control plane. It has 322 GitHub stars.

Is codexmate safe to use?

Yes. codexmate passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install codexmate?

Clone the repository with "git clone https://github.com/SakuraByteCore/codexmate" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is codexmate written in?

codexmate is primarily written in JavaScript. It is open-source under SakuraByteCore on GitHub, so you can review or fork the full source.

Are there alternatives to codexmate?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh codexmate against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

claude-code-lsp-enforcement-kit 49Agents

Codex Mate

One dashboard for all your local AI coding agents. Switch providers, manage sessions, and orchestrate tasks across Codex, Claude Code, OpenCode, and OpenClaw. Zero cloud, local-first control plane.

[!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, OpenCode, and OpenClaw seamlessly.

What's So Special?

Unlike simple wrappers, Codex Mate acts as a Local Agent Bridge:

Unified Session Browser: Search, inspect, filter, and export local sessions across Codex, Claude Code, Gemini CLI, and CodeBuddy Code from one place.
OpenAI-Compatible Bridge: Use Codex with any OpenAI-compatible UI by normalizing the Responses API; the built-in Codex conversion also fills and normalizes Codex fingerprint headers such as User-Agent, Version, OpenAI-Beta, and Originator so upstream providers see an official Codex CLI-shaped request.
Claude Provider Bridge: Connect Claude Code to OpenAI Chat Completions-compatible providers and Ollama through the built-in local Claude-compatible proxy.
OpenCode Provider Control: Manage OpenCode provider/model selection with a CodexMate-owned provider store under ~/.codexmate, projecting only the active provider into native OpenCode config to avoid polluting or deleting user-owned settings.
Provider Health Cleanup: Probe local Codex and Claude provider routes, surface failed configs in one modal, and bulk-clean selected broken providers without touching healthy or protected entries.
Skills Marketplace: A local-first market to share and import skills between different agent apps.
Prompt File Editor: Unified editor for global and project-level CLAUDE.md and AGENTS.md with auto-detection of project paths, plus a shared preset pool for reusable prompts.
Task Orchestrator: Plan and execute complex tasks with dependency tracking.

Current Progress

Feature	Status	Description
Provider Management	✅	Switch providers/models for Codex, Claude, OpenCode, and OpenClaw
Live Agent Sync	✅	Real-time monitoring of Codex/Claude config & status
Session Browser	✅	Search, preview, filter, and export sessions across Codex, Claude Code, Gemini CLI, and CodeBuddy Code
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 and attach/normalize Codex fingerprints in the built-in conversion
Claude Provider Bridge	✅	Connect Claude Code to OpenAI Chat Completions-compatible providers and Ollama via the built-in Claude-compatible proxy
OpenCode Provider Store	✅	Keep multiple OpenCode providers in `~/.codexmate` while projecting only the selected provider to native OpenCode config
Provider Health Check	✅	Probe local Codex/Claude provider routes, highlight failed configs, and bulk-remove selected broken providers safely
Prompt Templates	✅	Reusable prompt plugins with variables
Prompt File Editor	✅	Edit global and project-level CLAUDE.md / AGENTS.md with auto-detect, path switching, and a shared preset pool. Applying a preset only updates the editor; save manually to write the file.
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)

brew tap SakuraByteCore/codexmate
brew install codexmate

Requires Node.js (brew install node if not present).

Install via npm

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:

CODEXMATE_PORT=8080 codexmate run

Windows PowerShell:

$env:CODEXMATE_PORT=8080; 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
OpenCode: install from the official OpenCode docs

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]
        OpenCodeDir[~/.config/opencode]
        MateDir[~/.codexmate]
        State[Sessions/Usage/Trash]
    end

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

    API --> Config & Session & Skills & Tasks

    Config --> CodexDir & ClaudeDir & ClawDir & OpenCodeDir & MateDir
    Session --> State
    Skills --> Local