Codexia

A powerful GUI and Toolkit for Codex CLI

Create custom agents, manage interactive Codex CLI sessions, run secure background agents, fork chat, file-tree integration, prompt notepad, git diff, build-in pdf csv/xlsx viewer, and more.

codexia is a powerful desktop application that transforms how you interact with Codex CLI. Built with Tauri 2, it provides a beautiful GUI for managing your Codex CLI sessions, creating custom agents, tracking usage, and much more.

Think of codexia as your command center for Codex CLI - bridging the gap between the command-line tool and a visual experience that makes AI-assisted development more intuitive and productive.

▶️ Watch the automation video on Twitter

• Visual Project Browser: Navigate through all your Codex CLI projects in ~/.codex/config.toml
• Session History: View and resume past coding sessions with full context, Rename chat title, manage ~/.codex/sessions
• multiple windows: open multiple projects at the same time
• Category and fav conversatins

• worktree + sync to prevent accident delete all the changes. undo function.

• remote control from browser via any device

• PDF text selection
• CSV/XLSX preview & selection

• Notepad-chat integration

• Multiple AI providers (OpenAI, Ollama, Gemini, openrouter, xAI, Custom) - see config.toml
• Per-session model configs
• Adjustable sandbox policies
• Custom approval workflows

• Cost Tracking: Monitor your usage and costs in real-time
• Token Analytics: Detailed breakdown by model, project, and time period
• Visual Charts: Beautiful charts showing usage trends and patterns

• Server Registry: Manage Model Context Protocol servers from a central UI
• Easy Configuration: Add servers via UI or import from existing configs
• Want more?: use mcp-linker to manage mutil clients include Codex CLI with marketplace.

• Sandbox execution modes for safe code running
• Approval workflows for sensitive operations
• Configurable command execution policies
• Isolated processes per session for security
• image input
• Screenshot as image input
• toggle codex built-in gpt-5 web search

• Built-in Editor: Edit AGENTS.md file directly within the app
• Live Preview: See your markdown rendered in real-time
• Syntax Highlighting: Full markdown support with syntax highlighting

• Responsive UI with shadcn/ui
• Config panel
• Syntax-highlighted markdown
• Todo plan display
• Fork chat
• Persistent UI state
• Auto WebPreview (e.g., Next.js http://localhost:3000)
• Theme & Accent selection

1. Launch codexia: Open the application after installation
2. Welcome Screen: Choose a project or open a project
3. First Time Setup: codexia will automatically detect your ~/.codex directory

Projects → Select/Open Project → View Sessions → Resume or Start New

• Click on any project to view its sessions
• Each session shows the first message and timestamp
• Resume sessions directly or start new ones

Configure → Input your prompt → Agent start → Execute

1. Design Your Agent: Input your prompt,

• option steps

• type @ to show file select
• One-click @ file or folder
• Prompt optimizer

2. Set Permissions: chat and plan, Agent, Agent(full), Configure file read/write and toggle network access icon
3. Configure Model: Choose between available Codex models
4. Set Reasoning Effort: Configure reasoning models, choose between available Reasoning Effort levels
5. (option) Choose image or screenshot: click image icon or screenshot icon
6. Execute Tasks: Run your agent on selected project by sending prompt

Select/Open Project -> Manage Sessions

1. Select/Open Project
2. Manage Sessions: Rename/batch Delete/Delete/Fav/Category

Menu → Usage Dashboard → View Analytics

• Monitor costs by model, project, and date

Menu → MCP Manager → Add Server → Configure

• Quick Add Servers - desktop-commander and deepwiki
• Manage MPC Servers - Add, Edit, delete, enable/disable
• If you want more features for MCP Servers, get mcp-linker - mcp marketplace, add and sync mcp servers for multi clients

Menu → Settings → Remote access → Static bundle path - start

1. build static asset

bun run export:bindings
bun run build

2. start remote server

Your donation will be used to support Codexia’s continued development, server costs, new feature research, and long-term maintenance. Thank you for helping this project grow!

• Polar Donate (credit card friendly)
• Crypto donations
  • USDC (ERC20): 0xBE18F2cf09eE294781B98DBB1653f64ed54a911C
  • Bitcoin (BTC): bc1qg6xyywh76wkz9glf7n5pnt458yczzgk9eykkt9

• ✅ Interactive chat
• ✅ Code generation/editing
• ✅ File operations with sandbox
• ✅ Command execution with approval
• ✅ Multiple AI providers
• ✅ Project-aware assistance
• ✅ Streaming responses
• ✅ Built-in Web Search

• Codex CLI: Install from github Codex
• Git: recommend option install git

• release
• modern-github-release

brew tap milisp/codexia
brew install --cask codexia

Before building codexia from source, ensure you have the following installed:

• Operating System: Windows 10/11, macOS 11+, or Linux (Ubuntu 20.04+)
• RAM: Minimum 4GB (8GB recommended)
• Storage: At least 1GB free space

1. Rust (1.70.0 or later)

   # Install via rustup
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. Bun (latest version)

   # Install bun
   curl -fsSL https://bun.sh/install | bash

3. Git

   # Usually pre-installed, but if not:
   # Ubuntu/Debian: sudo apt install git
   # macOS: brew install git
   # Windows: Download from https://git-scm.com

Linux (Ubuntu/Debian)

# Install system dependencies
sudo apt update
sudo apt install -y \
  libwebkit2gtk-4.1-dev \
  libgtk-3-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev \
  patchelf \
  build-essential \
  curl \
  wget \
  file \
  libssl-dev \
  libxdo-dev \
  libsoup-3.0-dev \
  libjavascriptcoregtk-4.1-dev

macOS

# Install Xcode Command Line Tools
xcode-select --install

# Install additional dependencies via Homebrew (optional)
brew install pkg-config

Windows

• Install Microsoft C++ Build Tools
• Install WebView2 (usually pre-installed on Windows 11)

1. Clone the Repository

   git clone https://github.com/milisp/codexia.git
   cd codexia

2. Install Frontend Dependencies

   bun install

3. Build the Application

   For Development (with hot reload)

   bun tauri dev

   For Production Build

   # Build the application
   bun run export:bindings or codex generate-ts --out src/bindings
   bun tauri build
   
   # The built executable will be in:
   # src-tauri/target/release/

4. Platform-Specific Build Options

   Debug Build (faster compilation, larger binary)

   bun tauri build --debug

   Universal Binary for macOS (Intel + Apple Silicon)

   bun tauri build --target universal-apple-darwin

1. "cargo not found" error

   • Ensure Rust is installed and ~/.cargo/bin is in your PATH
   • Run source ~/.cargo/env or restart your terminal

2. Linux: "webkit2gtk not found" error

   • Install the webkit2gtk development packages listed above
   • On newer Ubuntu versions, you might need libwebkit2gtk-4.0-dev

3. Windows: "MSVC not found" error

   • Install Visual Studio Build Tools with C++ support
   • Restart your terminal after installation

4. "codex command not found" error

   • Ensure Codex CLI is installed and in your PATH
   • Run type codex to show codex path
   • Test with codex --version

5. Build fails with "out of memory"

   • Try building with fewer parallel jobs: cargo build -j 2
   • Close other applications to free up RAM

After building, you can verify the application works:

# Run the built executable directly
# Linux/macOS
./src-tauri/target/release/codexia

# Windows
./src-tauri/target/release/codexia.exe

The build process creates several artifacts:

• Executable: The main codexia application
• Installers (when using tauri build):
  • .deb package (Linux)
  • .AppImage (Linux)
  • .dmg installer (macOS)
  • .msi installer (Windows)
  • .exe installer (Windows)

All artifacts are located in src-tauri/target/release/.

• Frontend: React 19 + TypeScript + Vite 7
• Backend: Rust with Tauri 2
• UI Framework: Tailwind CSS v4 + shadcn/ui
• Package Manager: Bun

codexia/
├── src/                    # React frontend source
│   ├── components/         # UI components
│   ├── hooks/              # Custom React hooks
│   ├── store/              # Zustand state management
│   ├── services/           # Business logic services
│   └── types/              # TypeScript type definitions
├── src-tauri/              # Rust backend source
│   ├── src/
│   │   ├── lib.rs          # Main Tauri application
│   │   └── codex           # Codex process management
├── public/                 # Public assets

# Start development server
bun tauri dev

# Run frontend only
bun run dev

# Type checking
bunx tsc --noEmit

# Run Rust tests
cd src-tauri && cargo test

# Format code
cd src-tauri && cargo fmt

Codexia prioritizes your privacy and security:

• Local Storage: All data stays on your machine
• No Telemetry: No data collection or tracking
• Open Source: Full transparency through open source code

• MacOS damaged warning 🎥Youtube The app not sign yet, You can open it by running the terminal command:

xattr -cr /Applications/codexia.app
open -a /Applications/codexia.app  # or click the Codexia app

• MCP tool call
• More file format support
• Better UI customization
• Plugin system
• Advanced debugging tools
• Real-time collaboration
• Performance optimizations
• token count

🚀 Call to Action

If you’re a developer, designer, or AI tinkerer — Join us on this exciting journey to redefine the developer experience with AI. Contribute to the project, share your feedback, and help build the future of intelligent coding environments. Together, we can make Codexia the go-to platform for developers worldwide!

Join the Discussions

• jeremiahodom/codex-ui - Node.js backend with API/SSE communication
• Itexoft/codexia - SSH integration
• nuno5645/codexia - add support for new reasoning and token count events

• awesome-codex-cli - A curated list of awesome resources, tools for OpenAI Codex CLI

We welcome contributions! Please see our Contributing Guide for details.

• 🐛 Bug fixes and improvements
• ✨ New features and enhancements
• 📚 Documentation improvements
• 🎨 UI/UX enhancements
• 🧪 Test coverage
• 🌐 Internationalization

Thanks to all our wonderful contributors!

This project is licensed under the MIT License - see the LICENSE file for details.

Codexia is an independent open-source project and is not built by OpenAI or any company.

• Plux one click @files from FileTree & notepad
• Claude code Co-Authored-By Claude code
• codex for the Codex CLI
• Tauri for the excellent desktop app framework
• shadcn/ui for the beautiful UI components
• ChatGPT Some code suggest by ChatGPT
• The open source community for the amazing tools and libraries