https://github.com/hl9565/codexpilot
让 Codex 的本地使用更可控、更顺手。A local companion for a more controllable and comfortable Codex experience.
https://github.com/hl9565/codexpilot
codex codex-app desktop-app rust session-management tauri
Last synced: 18 days ago
JSON representation
让 Codex 的本地使用更可控、更顺手。A local companion for a more controllable and comfortable Codex experience.
- Host: GitHub
- URL: https://github.com/hl9565/codexpilot
- Owner: hl9565
- License: mit
- Created: 2026-05-20T02:12:20.000Z (24 days ago)
- Default Branch: main
- Last Pushed: 2026-05-23T14:26:13.000Z (21 days ago)
- Last Synced: 2026-05-23T14:27:40.508Z (21 days ago)
- Topics: codex, codex-app, desktop-app, rust, session-management, tauri
- Language: Rust
- Size: 2.24 MB
- Stars: 29
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
- License: LICENSE
Awesome Lists containing this project
README
CodexPilot
Make local Codex workflows smoother and more controllable.
CodexPilot is for people who already use Codex App locally. It provides a local manager and connects to running Codex pages through Chromium DevTools Protocol. Use it to launch Codex, export sessions, manage the recycle bin, sync Provider ownership, configure Hybrid Relay, and inspect diagnostics, without modifying Codex App's installed files or replacing the app.
> CodexPilot is unofficial and is not affiliated with OpenAI or Codex App.
## Quick Start
1. Open [GitHub Releases](https://github.com/hl9565/CodexPilot/releases) and download the package for your platform from the Assets section. Do not use the Source code archive as an installer.
- Windows: download `CodexPilot-*-windows-x64-setup.exe` and run the installer.
- macOS Apple Silicon: if the release provides `CodexPilot-*-macos-arm64.dmg`, open it and drag `CodexPilot.app` into Applications.
2. Open the CodexPilot manager, go to Launch, confirm the Codex path, and click Launch.
3. After Codex opens, use the CodexPilot menu to export the current session.
4. For custom model requests, configure Hybrid Relay in Model Channel.
5. To maintain historical sessions, use Dialog Maintenance for recycle bin cleanup or Provider ownership sync.
Current macOS packages are not signed with an Apple Developer ID and are not notarized. If macOS cannot verify the app, read the note inside the DMG before using the bundled helper script.
macOS Intel builds are not currently published as verified release assets. If you use an Intel Mac, build and verify it from source.
## Highlights
### Hybrid Relay
Hybrid Relay is a key CodexPilot feature. It keeps the official Codex/ChatGPT login state while routing model requests to a custom compatible API. This lets you keep using mobile ChatGPT to control or continue desktop Codex, while desktop Codex sends model requests through your own relay provider.
The custom Provider receives those model requests, so its privacy, billing, and data handling policies apply.
### Provider Ownership Sync
After switching model channels, historical sessions may disappear or group incorrectly because their Provider metadata no longer matches. CodexPilot does not rewrite historical data automatically; in Dialog Maintenance, you can preview the impact first, then manually sync session ownership to the selected Provider.
## Other Features
- Launch and injection
- Session export
- Timeline
- Dialog maintenance
- Archived session handling
- Diagnostics snapshots
See [docs/features.en.md](docs/features.en.md) for the full feature guide.
## Local Data And Security
CodexPilot reads or writes configuration, sessions, archived sessions, state databases, and backup directories under your local `~/.codex` directory. Relay profiles are stored locally. API keys are hidden in status panels, but they are still written to local configuration files.
Use CodexPilot only on trusted devices, and avoid uploading local config, logs, screenshots, or backup directories to public repositories. When using a custom compatible API, verify the provider's privacy, billing, and data handling policies yourself.
See the [feature guide](docs/features.en.md#local-data-and-security) for the full data scope.
## Docs
- [Feature guide](docs/features.en.md): launch, model channels, dialog maintenance, Provider sync, diagnostics, and local data.
- [README guidelines](docs/development/readme-guidelines.md): homepage information architecture and copy rules, currently in Chinese.
## Support
For usage questions, feedback, and release updates, you can join the WeChat group.
This project links back to and recognizes the [LINUX DO](https://linux.do/) community. Feedback, usage notes, and improvement ideas are welcome in the community discussion thread.
## License
MIT