explaingit

hl9565/codexpilot

13RustAudience · developerComplexity · 4/5ActiveSetup · hard

TLDR

Tauri desktop manager for OpenAI Codex that attaches via Chromium DevTools Protocol and adds session export, archive browsing, provider attribution sync, and a hybrid request relay to a custom OpenAI compatible API.

Mindmap

mindmap
  root((CodexPilot))
    Inputs
      Running Codex page
      User OpenAI compatible API
      Local ~/.codex folder
    Outputs
      Session exports
      Provider attribution sync
      Diagnostic logs
    Use Cases
      Manage Codex sessions
      Route requests to a custom provider
      Repair Gatekeeper blocks
    Tech Stack
      Rust
      Tauri
      Chromium DevTools Protocol
      Windows
      macOS

Things people build with this

USE CASE 1

Route Codex model requests through a personal OpenAI compatible API while staying signed in to the official account

USE CASE 2

Export and archive Codex sessions for backup or sharing with a team

USE CASE 3

Sync provider attribution on historical sessions after switching model channels

USE CASE 4

View diagnostic logs to debug why a Codex session fails to attach

Tech stack

RustTauriChromium DevTools ProtocolWindowsmacOS

Getting it running

Difficulty · hard Time to first run · 1h+

macOS build is not Apple Developer ID signed so Gatekeeper blocks it without a repair script; Intel Macs must compile the Rust and Tauri sources themselves.

In plain English

CodexPilot is a Tauri desktop app written in Rust that acts as a local companion to OpenAI's Codex app. The README is in Simplified Chinese with an English version linked. The project is described as an unofficial tool not affiliated with OpenAI or the Codex app team. It does not modify the Codex install or replace Codex itself. Instead it connects to a running Codex page via the Chromium DevTools Protocol and adds a management layer around it. From the manager window the user can launch Codex, export a session, work through archived sessions, sync provider attribution, configure a hybrid request relay, and view diagnostic logs. The headline feature is what the README calls a hybrid relay. This keeps the user signed in to the official Codex or ChatGPT account so the desktop or mobile experience still works, but routes the actual model requests through a user-defined OpenAI-compatible API. The README is clear that the privacy, billing, and data-handling policy of those requests then become whatever the chosen provider says they are. A related feature is provider-attribution sync. When the user switches model channels, historical sessions can become invisible or end up wrongly grouped because of mismatched provider metadata. CodexPilot does not rewrite that history on its own. The user can preview the affected range in the dialog-maintenance view and then sync session attribution to the chosen provider by hand. Distribution is via GitHub Releases as a Windows installer and a macOS Apple Silicon DMG. The macOS package is not Apple-Developer-ID signed or notarised, so the README points users to the included DMG instructions and a repair script if Gatekeeper blocks the app. macOS Intel users have to build from source. CodexPilot reads and writes the local ~/.codex folder for configuration, sessions, archives, and a state database, and the README warns against uploading those files to public repositories.

Copy-paste prompts

Prompt 1
Walk me through downloading CodexPilot from GitHub Releases and getting past the macOS Gatekeeper block on an Apple Silicon Mac.
Prompt 2
Explain how CodexPilot attaches to a running Codex page via the Chromium DevTools Protocol and what ports it needs.
Prompt 3
Help me configure the hybrid relay in CodexPilot to point at a local OpenAI compatible endpoint on port 8080.
Prompt 4
Show me how to use the dialog maintenance view in CodexPilot to sync provider attribution on a range of old sessions.
Prompt 5
Build CodexPilot from source on a macOS Intel machine including any Rust and Tauri prerequisites.
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.