Codexia

Lightweight Agent command center for Codex + Claude Agent + ACP agents

Lightweight Agent Workstation for Codex CLI + Claude Agent + any Agent Client Protocol (ACP) agent — with task scheduler, git worktree & remote control, skills management, and a prompt notepad in one workspace

💡 Maintained by @milisp · Follow me on 𝕏 for agentic workflows, building in public, and project updates Sponsorship or custom work: milisp@proton.me

• 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

• Codex CLI
• Claude Code CLI, which powers Claude Agent (see usage and billing)
• Optional: any agent that speaks the Agent Client Protocol

brew install --cask codexia

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

• GitHub Releases

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

1. Launch Codexia.
2. Add your project directory.
3. Enter a prompt and start your agent session.
4. Create an Agent Task Scheduler job for recurring workflows.

Claude Agent in Codexia runs your own locally installed Claude CLI through the Claude Agent SDK. Codexia never signs in to claude.ai on your behalf; it uses whatever authentication your CLI already has.

• Claude subscription (Pro / Max / Team / Enterprise): usage from Codexia is programmatic, so it counts against your plan's monthly Agent SDK credit, billed at API rates. It does not draw from your regular interactive Claude Code limits, and the credit does not roll over.
• API key (ANTHROPIC_API_KEY): usage is billed to your Anthropic Console account. Recommended for heavy use.

Codexia asks you to acknowledge this once before the first Claude Agent prompt; the answer is stored in ~/.codexia/cc-consent.json. Plan limits and terms are set by Anthropic and may change, so check Anthropic's documentation for the current details. Codexia is an independent project and is not affiliated with Anthropic.

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

• 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

• 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)

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/

• Usage
• Architecture
• Web Server

• Process isolation: Agents run in separate processes
• Permission control: Configure file and network access per agent
• Local storage: All data stays on your machine
• Open source: Full transparency through open source code

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

Related:

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

• GitHub Discussions
• Report Bug / Request Feature

Licensed under the MIT License.