Use and adapt codex-electron-clone

Use the documented interfaces and source layout for codex-electron-clone. The sections below retain the README’s examples and configuration details.

Screenshots

Sidebar and header	Project composer

Run

1npm install
2npm start

Requires Node.js and npm. The interface is a local visual prototype. Its chat response is a placeholder; no Codex account or agent service is connected.

To build the macOS desktop application on Apple Silicon:

1npm run package:mac

The built .app appears in ../build/Codex UI Clone-darwin-arm64/. It can be opened like a normal macOS application.

Browser preview

Open index.html directly in a browser. The file picker uses the browser's own dialog there; Electron uses the native desktop dialog. Drag the narrow divider beside the sidebar to resize it. Use the magnifying glass or Cmd/Ctrl+K for the search page. Hover over a chat to remove it from this local preview.

Commands in the root manifest

The captured package.json declares the following scripts. Run them from the directory containing that manifest.

Command	Script
`npm run start`	`electron .`

Troubleshoot a local change

Reproduce the smallest example from the quick-start guide.
Compare required configuration and dependency versions with the README.
Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.

Source and help