CodexTools

CodexTools is a standalone Go + React manager extracted from the Codex++ refactor work. It keeps the task-oriented manager UI, the relay and provider tooling, script management, diagnostics, and repair workflows in one repo that can be built and published independently.

What it includes

• A Go backend that serves the web UI and keeps the command contract stable.
• A Gemini-inspired manager UI redesigned for non-technical users.
• Relay profile management, provider sync, script market integration, logs, diagnostics, and repair tools.
• A self-contained repository layout so the manager can be built without the original monorepo.

Repository layout

• main.go: binary entry point, build-time role switch, embedded assets, and shared constants.
• manager.go: local HTTP manager, static UI serving, command dispatch, Codex app discovery, and CCS provider import.
• launcher.go: silent launcher flow, Codex process startup, restart handling, and launch status updates.
• helper.go: helper HTTP server, local relay proxy, CORS responses, and image/text relay routing.
• bridge.go: Chrome DevTools Protocol integration, renderer bridge injection, and bridge request handling.
• settings.go: settings defaults, persistence, repository root detection, and embedded/web dist lookup.
• relay.go: relay profile application, auth/config status, relay file editing, and relay profile tests.
• repair.go: Codex config repair, plugin recovery, provider sync, SQLite/global-state maintenance, and TOML table repair helpers.
• scripts.go: script market loading, script install/delete, and user script inventory.
• entrypoints.go: desktop entry/app bundle/shortcut installation and Windows watcher support.
• diagnostics.go: diagnostic log writing, log tailing, and support report generation.
• toml.go: focused TOML string helpers used by relay and repair flows.
• util.go: small shared HTTP, JSON, path, argument, and type-conversion helpers.
• types.go: shared backend data structures.
• desktop_darwin.go, desktop_other.go: platform-specific manager window hooks.
• web/: React + Vite manager UI.
• docs/: GitHub Pages project introduction, download page, and public assets.

The Go backend is still one package main so release scripts can keep using -ldflags "-X main.binaryRole=...", but the implementation is split by responsibility to reduce merge conflicts and make ownership clearer.

Run locally

npm --prefix web install
npm --prefix web run vite:build
go run .

Build

npm --prefix web run check
npm --prefix web run vite:build
go build -o codextools .

Feature overview

1. Simple launch surface The home screen exposes only the actions a normal user needs first: launch, connect service, inspect status, and repair paths.
2. Relay and API management Profiles support official login, compatible API mode, protocol switching, relay testing, and injection helpers.
3. UI enhancement controls The manager keeps feature toggles, launch mode selection, and script-related tooling in one place.
4. Script center Users can install, enable, disable, update, and remove user scripts without editing config files manually.
5. Recovery and diagnostics Built-in logs, diagnostics output, path repair, and shortcut repair reduce support friction.
6. Legacy conversation repair Provider sync tools help recover visibility for older local conversations.

Screenshots

The project introduction page now includes real manager screenshots with feature descriptions:

Home dashboard

The first screen shows whether the local setup is ready, exposes the primary launch button, and keeps connection, UI features, and repair entry points close together.

Beginner guide

The guided flow checks platform and architecture, confirms Codex installation, imports CCSwitch providers, selects the connection mode, and ends at launch.

• Home dashboard: launch status, active connection, UI enhancement mode, entry paths, and key health checks.
• Beginner guide: system detection, Codex install check, CCSwitch import, mode selection, and Codex++ launch flow.
• Connection service: official login, mixed API mode, relay/API providers, CCSwitch import, and connectivity testing.
• UI features: session delete, Markdown export, project move, Timeline, plugin entry unlock, and forced plugin install controls.

Screenshot assets live in docs/assets/ and are referenced directly by the public project page.

New in 1.1.8

• Published standalone macOS and Windows desktop packages from this repository.
• Restored clearer relay mode switching for official login, compatible API, and relay workflows.
• Fixed restart handling when users switch mixed API modes.
• Improved launcher behavior so injection failures degrade more gracefully.

Telegram community

Telegram: https://t.me/wanai8

Project origin and thanks

CodexTools is a standalone Go refactor and manager UI project based on the earlier Codex++ work. Thanks to the original Codex++ project for the foundation, workflow ideas, and user-facing tool direction.

• Original project: https://github.com/BigPizzaV3/CodexPlusPlus
• Refactor source: https://github.com/hereww/CodexPlusPlus
• Standalone project: https://github.com/hereww/codextools

Downloads

• GitHub Pages download page: docs/downloads.html

Project introduction page

The repository includes an English-first project page with a Chinese switch button:

• Open project intro

GitHub Pages can publish the docs/ folder automatically through the included workflow after the repository is pushed.

Notes

• The backend still targets the Codex/Codex++ local workflow and keeps compatibility-oriented command names where that reduces migration risk.
• Watcher install and removal are implemented for Windows. macOS shows an explicit platform limitation and keeps only the local enable/disable flag controls.