The codex-theme-controller is a native macOS utility created using SwiftUI, designed for managing color themes in active Codex instances seamlessly. This application utilizes the Chrome DevTools Protocol (CDP) to automatically detect running Codex processes without the need for manual PID or port identification, offering a more efficient workflow.

Key Features

• Automatic Discovery: Quickly scans for running Codex instances, displaying information such as PID, command, and the --remote-debugging-port.
• User-Friendly Menu Bar Icon: Access quick actions through a convenient menu bar icon, enabling options to open the window, refresh settings, apply themes across all instances, or launch new instances.
• Diverse Theme Options: Offers several themes including Darcula, Dracula, Nord, and Monokai for user customization.
• Instant Theme Application: Themes can be selected and applied immediately to all active Codex instances, enhancing usability.
• Batch Application: Supports applying the selected theme to all instances with a single action, simplifying color theme management.
• Launch with Theme: New Codex instances can be launched with a designated debug port, automatically applying the selected theme on startup.
• Persisted Preferences: The last selected theme is saved, ensuring a consistent experience across app launches.

Requirements

• Compatible with macOS 14+.
• Requires Xcode 16+ and Swift 6+.
• Codex instances must be initiated with the --remote-debugging-port=<port> option to utilize theme application.

Getting Started

To run the application, use the following command:

make run-app

This command builds the app bundle and launches it, allowing for standard macOS application behavior with a Dock icon and tray icon. Users can easily manage the window and settings from the tray menu.

Testing

For testing, use:

swift test
swift build

The codex-theme-controller simplifies the process of applying and managing themes in Codex, enhancing the development experience for macOS users.