CodexFlow

<div align="center">
<br/>

<!-- Badges -->
<a href="https://github.com/lulu-sk/CodexFlow/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/lulu-sk/CodexFlow?style=for-the-badge&logo=undertale&logoColor=red&color=orange"/></a>
<a href="https://github.com/lulu-sk/CodexFlow/releases"><img alt="Downloads" src="https://img.shields.io/github/downloads/lulu-sk/CodexFlow/total?style=for-the-badge&label=Downloads"/></a>
<img alt="Platform" src="https://img.shields.io/badge/Windows%2011+WSL-Recommended-blue?style=for-the-badge&logo=windows"/>
<img alt="Electron" src="https://img.shields.io/badge/Electron-App-informational?style=for-the-badge&logo=electron"/>
<img alt="React" src="https://img.shields.io/badge/React-18-informational?style=for-the-badge&logo=react"/>
<a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0-success?style=for-the-badge"/></a>

</div>

<br/>

| English | [简体中文](./README.zh-CN.md) |
| --- | --- |

# CodexFlow

> A "Unified Workbench" crafted for **AI Coding Agents** — switch between **Codex / Gemini / Gemini** (and custom engines) in one click, organize sessions and history by **project directories**, run parallel tasks with **Git Worktree**, browse and resume conversations with Markdown rendering, and provide a graphical input box for CLI with support for **pasting images / dragging files / @project files / full-screen input** for efficient prompting.

- **Platform Recommendation**: **Windows 11 + WSL (Default Distro: Ubuntu-24.04)**; provides the best experience when WSL is installed and engines are available within it. **PowerShell Mode** (PS5 / PS7 / CMD) is also fully supported.
- **Project Structure**: **UI Host with a Minimal Terminal Bridge** (Electron + React + Vite + node-pty + xterm).

---

## Table of Contents

- [Core Features](#-core-features)
- [Interface Overview](#-interface-overview)
- [Quick Start](#-quick-start)
- [Usage Tips](#-usage-tips)
- [Development & Build](#-develop