codexia

Lightweight Agent Workstation for Codex CLI + Claude Code — with task scheduler, git worktree & remote control, skills management, and a prompt notepad in one workspace

Want to become a sponsor? · Need custom dev / consulting? — AI agent integrations, MCP servers, multi-agent orchestration, Codex/Claude Agent SDK

Features

• Agent workflows: Task Scheduler for recurring jobs, remote control via headless web server
• 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

Installation

Homebrew (macOS)

brew tap milisp/codexia
brew install --cask codexia

Prebuilt releases (macOS / Linux / Windows)

• GitHub Releases

Quick Start

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.

Recommend tools

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

• Usage
• Architecture
• Web Server

🔒 Security

• 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
• Telemetry: Opt-in only, off by default

Contributing

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

Community forks:

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

Related:

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

Community

• GitHub Discussions
• Report Bug / Request Feature

License

Dual-licensed under AGPL-3.0 (open source) and a Commercial License (closed-source / SaaS use). See COMMERCIAL.md for details.

---

Other Projects

If you like this tool, check out my other open-source works:

• seeker - Deepseek Agent command center.