Codexia

A lightweight agent workstation for Claude Code and Codex

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.

!Codexia Home

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

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

Quick Start

1. Launch Codexia.
2. Sign in with your Claude account or ChatGPT account.
3. Add your project directory.
4. Enter a prompt and start your agent session.
5. 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

• 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

• 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

• 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

• Usage
• Bots
• Architecture
• Web Server

🔒 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

• GitHub Discussions
• Report Bug / Request Feature

Support & Contact

For custom work, contact [email protected].

License

Licensed under the MIT License.