Skip to content

milisp/codexia

Repository files navigation

Codexia

Downloads Discord Follow on 𝕏

Codexia is a Tauri v2 app for Codex CLI + Claude Code — combining agent workflows, an IDE-like editor, a headless web server, and a prompt notepad in one workspace.

Codexia Home

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

Installation

Homebrew (macOS)

brew tap milisp/codexia
brew install --cask codexia

Prebuilt releases (macOS / Linux / Windows)

Ecosystem

  • Agent Tools: Tools for Codex or Claude code
  • Agent Skills Marketplace: Prompt workflows and task automations.
  • MCP Server Marketplace: Extend agent capabilities with local or remote MCP tools.

Weekly Marketplace Spotlights

👉 Have a great Server or Skill? We feature outstanding community submissions in our Weekly Spotlights and sync them into the built-in App Marketplace. See CONTRIBUTING.md to submit yours!

Featured Agent Tools

  • Relay Baton - Local Codex Desktop/CLI recovery monitor for long-running tasks. Detects compact failures and context-window overflow, then queues audited handoff bundles.
  • Agentbox - AgentBox runs multiple Codex (and Claude Code / OpenCode) sessions in parallel

Featured Agent Skills

  • trace-to-skill - CLI for turning failed Codex, Claude Code, Cursor, and MCP-enabled agent runs into reusable AGENTS.md rules, SKILL.md files, eval evidence, PR comments, and SARIF code-scanning reports.
  • Codex Small Business Skills by Simon Gonzalez De Cruz - Apache-2.0 Codex port of Anthropic's Small Business skills, with 31 workflows for cash flow, invoices, CRM, support, marketing, hiring, and weekly business rhythm.

🛠️ Featured MCP Servers

  • VideoOverlayKit - MCP server that renders 4-6s animated b-roll overlay videos (mp4) for short-form social (LinkedIn, IG Reels, YouTube Shorts, TikTok). Paste your script into Codex CLI / Claude Code / Cursor, the model writes the scene spec and renders the mp4. Built on Remotion + Tabler + Lottie. Free, MIT, local.
  • claude-codex-bridge - Bidirectional MCP bridge for Codex CLI and Claude Code collaboration, with persistent Claude sessions and shared collaboration files.

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.

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 src-tauri/src/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)
  • src-tauri/src/web/server.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 src-tauri/src/web/handlers/
  • Register routes in src-tauri/src/web/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: 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:

Related:

Community

License

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