Codexia

A powerful GUI and Toolkit for Codex CLI + Claude code

one click @file from FileTree, prompt notepad, git worktree, diff view, build-in one click pdf csv/xlsx viewer, and more.

[!TIP] ⭐ Star this repo, follow milisp on GitHub for more projects, and follow @lisp_mi on Twitter for updates.

▶️ Automation demo on Twitter

📋 Table of Contents

• ✨ Features
• ✨ Claude code features
• 🚀 Installation
• 📖 Quick start

✨ Features

🗂️ Project & Session Management

• Visual Project Browser: Navigate through all your Codex CLI projects in ~/.codex/config.toml and any ~/.codex/sessions/**/*.jsonl first line has cwd
• Session History: View and resume past coding session with full context, Rename chat title, manage ~/.codex/sessions
• filter conversation messages
• Multiple windows: open multiple projects at the same time
• Category & Favorites conversation system

git worktree and sync file changes

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

remote control

• remote control from browser via any device

Built-in multi file viewer format support

One Click pdf/xlsx/csv from filetree to preview

• PDF text selection
• CSV/XLSX preview & selection

Prompt notepad

• Notepad-chat integration

📊 Usage Analytics Dashboard

• 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

🔌 MCP Server Management

• simple mcp management
• One click add from mcp marketplace or sync mcp server via mcp-linker

📝 AGENTS.md

• 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

🎯 Professional UX

• Syntax-highlighted markdown
• Todo plan display
• ~~Fork chat~~
• Persistent UI state
• WebPreview (e.g., Next.js http://localhost:3000)
• Theme & Accent selection

📋 Codex CLI features

• 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 or image file
• toggle codex built-in gpt-5 web search
• Project-aware assistance
• Multiple AI providers (OpenAI, Ollama, Anthropic, Gemini, openrouter, xAI, Custom)

sqlite in ~/.codexia/cache.db

• note
• sesssion list - scan new session to store in sqlite
• token usage

Claude code features

• see opcode

🚀 Installation

Prerequisites

• Codex CLI: Install from github Codex
• Claude Code CLI: Install from Claude's official site
• Git: recommend option install

Download

• release
• modern-github-release

macOS homebrew

brew tap milisp/codexia
brew install --cask codexia

📖 Quick start

• Launch Codexia app
• UI show Project with codex projects and Claude code projects

Codex

• Option step (config model, sandbox, approval)
• select a project then start task

Claude code

• select a project to show history sessions
• click session to show history

new cc session (agent)

• click bot icon (#2) from left sidebar - You will see opcode app ui
• click bot icon at right top (opcode app ui) - show agents
• Create Agent -> fill the form - save agent - run agent
• other steps see opcode

Remote control

Menu → Remote access -> start

Others

• Google or ask AI

💬 Discussions

Join the Discussions

Community forks

• 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

Related project

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

🤝 Contributing

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

By contributing to this project, you agree that your contributions may be licensed under both the AGPL-3.0 license and the Codexia commercial license.

Areas for Contribution

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

🙏 Acknowledgments

• Plux one click @files from FileTree & notepad
• Built with Tauri - The secure framework for building desktop apps
• Claude by Anthropic
• Codex by OpenAI

Report Bug · Request Feature

License

Codexia is dual-licensed under AGPL-3.0 and a Commercial License.

• AGPL-3.0 — for open-source use.
• Commercial License — required for closed-source, proprietary, hosted, or SaaS use.

For full terms and commercial inquiries, see COMMERCIAL.md.