Codexia 发布轻量智能体工作台，统一管理 Claude Code 与 Codex

A lightweight agent workstation for Claude Code and Codex

🚀 New: MCP Linker — sync MCP servers between Claude Code, Codex, Cursor & more — is live on Product Hunt!

Use your existing Claude subscription or ChatGPT plan — no API key required.

Build your team of Bots — long-lived AI coworkers with memory and scheduled routines. Manage Claude Code, Codex, and Agent Client Protocol (ACP) agents in one workspace, with git worktrees and remote control.

Your brand here. Sponsor Codexia.

🤖 Bots: AI coworkers that keep working

A bot is a named agent with its own project, persona, memory and permissions — you message it like a colleague, and it keeps working while you look elsewhere.

Trust levels that are enforced: Read-only, Ask before writing, or Autonomous — backed by the agent's OS sandbox, not just a prompt
You stay in charge of money: payments, purchases and deletions always wait for your approval, even in scheduled runs; approve on the desktop or over remote access
Persistent memory: each bot remembers across conversations and restarts
Routines: schedule prompts a bot runs on its own (daily, weekdays, every N hours); results land in its history with an unread badge and a system notification
Bots help each other: a bot can hand a job to another bot and use its answer
Your MCP servers: pick which ones each bot can use
Nothing to install: the keke agent ships inside Codexia

See docs/BOTS.md.

Features

Use your existing subscription: sign in with your Claude account or ChatGPT account and work within your plan's usage limits
Bots: long-lived AI coworkers with memory, routines, enforced trust levels and bot-to-bot help (see above)
Agent Client Protocol (ACP): Connect any external ACP agent — sessions persist across restarts, tool calls render live in the thread
Agent workflows: Task Scheduler for recurring jobs, remote control via headless web server (including iOS)
Workspace: Git worktree management, project file tree, IDE-like editor, prompt notepad, local web preview
Data tools: One-click PDF / XLSX / CSV preview
Ecosystem: MCP server marketplace, agent skills marketplace
Personalization: Theme and accent customization, usage analytics dashboard

Requirements

Codex CLI
Claude Code CLI, which powers Claude Agent
Optional: any agent that speaks the Agent Client Protocol

Installation

Homebrew (macOS)

brew install --cask codexia

Scoop (Windows)

scoop bucket add milisp https://github.com/milisp/scoop-bucket
scoop install codexia

Prebuilt releases (macOS / Linux / Windows)

GitHub Releases

Windows also ships a portable archive (codexia_<version>_x64_portable.zip) that runs without installing.

Quick Start

Launch Codexia.
Sign in with your Claude account or ChatGPT account.
Add your project directory.
Enter a prompt and start your agent session.
Create an Agent Task Scheduler job for recurring workflows.

Also by me

Plux - Capture now with a shortcut. Turn it into a todo, send it to AI anytime.

Recommend tools

keke - Local terminal coding agent with zero-vendor lock-in. Works with subscriptions, API keys, or self-hosted models; speaks ACP for editor/client integration
oh-my-codex - Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.
rtk - CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
ctx - Search the coding agent history already on your machine

Architecture at a Glance

Codex app-server integration
Claude agent rust sdk integration
Agent Client Protocol (ACP) client for external agents, with persisted sessions
Frontend: React + TypeScript + Zustand + shadcn/ui in src/
Desktop backend: Tauri v2 + Rust in src-tauri/src/
Headless backend: Axum web server for remote control in web/
Agent runtime: Codex app-server JSON-RPC integration for session/turn lifecycle
Real-time updates: WebSocket broadcast stream at /ws for browser clients

Core entry points:

src-tauri/src/lib.rs (desktop commands and state)
web/src/server_web.rs (headless server startup)
src-tauri/src/web/router.rs (HTTP API route surface)
src/services/tauri/ (frontend invoke layer)

API Surface

Codexia exposes a browser-accessible API when running in web/headless mode:

Health and stream: GET /health, GET /ws
Codex lifecycle: /api/codex/thread/*, /api/codex/turn/*, /api/codex/model/*, /api/codex/approval/*
Automation scheduler: /api/automation/* (create/update/list/run/pause/delete)
Files, git, and terminal: /api/filesystem/*, /api/git/*, /api/terminal/*
Claude integration: /api/cc/*
Notes and productivity: /api/notes/*, /api/codex/usage/token

Contributor note:

Add new API handlers under ./web/src/handlers/
Register routes in ./web/src/router.rs
Add corresponding frontend client calls in src/services/tauri/

Documentation

🔒 Security

Process isolation: Agents run in separate processes
Permission control: Configure file and network access per agent
Local storage: Your projects, conversations and bot memory stay on your machine. Optional anonymous usage counts are off until you say yes (details)
Open source: Full transparency through open source code

Contributing

Contributions are welcome. Read CONTRIBUTING.md for setup and workflow.

Community forks:

jeremiahodom/codex-ui — Node.js backend with API/SSE
nuno5645/codexia — Reasoning and token count events

awesome-codex-cli — curated list of Codex CLI resources

Community

Support & Contact

For custom work, contact milisp@proton.me.

License

Licensed under the MIT License.