codex-app-in-linux

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #llm #android #machine-learning #deep-learning #macos #windows #awesome #kubernetes #awesome-list #ios

codex-app-in-linux

(★ 40)

Evidence-backed proof for launching the Codex desktop app on Linux through an unofficial local wrapper

codex-app-in-linux 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Codex App on Linux

Proof that the Codex desktop app can run locally on Linux via an unofficial wrapper build.

<a href="reports/final-validation.md">Validation report</a> ·
 <a href="reports/multi-model-selection-first-pass.md">Multi-model first pass</a> ·
 <a href="evidence/build/build-info.json">Build info</a> ·
 <a href="evidence/gui/webview-smoke-result.txt">Smoke test</a>

> [!WARNING]
> Experimental proof of concept. This is **not** an official OpenAI Linux release and does **not** redistribute Codex Desktop, `Codex.dmg`, or generated app bundles.

## Summary

OpenAI ships the Codex desktop app for macOS and Windows. Linux is officially supported through Codex CLI, not a native desktop app. This repo documents a working Linux proof using an unofficial wrapper build that converts the upstream macOS `Codex.dmg` into a Linux Electron app.

Tested on Ubuntu 24.04.4 LTS / GNOME Wayland / x64.

## Multi-model selection first pass

This repo includes a non-invasive first-pass path for local multi-model selection: the earlier OpenCodex `10100` guidance is superseded by a CLIProxyAPI data-plane proxy on `127.0.0.1:8317`, with privileged management kept behind the bridge/BFF and wrapper-owned bubble path. Codex config points at that loopback data plane with a custom `model_provider`.

```bash
python3 scripts/codex-multi-model-config.py --model cliproxyapi/default --print-env
```

See `reports/multi-model-selection-first-pass.md` for the full flow and safety constraints.

## Result

| Check | Result |
| --- | --- |
| Local wrapper build | Passed |
| Generated Electron app launch | Passed; startup failure modal absent after `linux-owl-feature-binding-noop` |
| Webview server | Passed on `127.0.0.1:5175` |
| Electron process tree | Passed |
| Codex CLI app-server handshake | Passed |
| Login/account readiness | Passed for existing signed-in user state |
| Native install / updater / service | Not used |
| Project/thread/shell approval manual QA | Still recommended |

Smoke result (latest, 2026-06-20):

```text
http://127.0.0.1:5175/ -> HTTP 200
bootstrapFailed=false
owlBindingError=false
app routes mounted=true
ready message handled=true
account/read succeeded
browser_use_iab_backend_startup_ready=true
```

## Reproduce safely
### Computer Use / Chrome prerequisites

The wrapper build can start without Linux Computer Use support when the bundled plugin build is skipped. Before building, install a working Rust toolchain and the desktop-control helper so Chrome/Computer Use support is not accidentally omitted:

```bash
sudo apt-get install -y cargo rustc ydotool
cargo --version
```

Use Cargo `1.78.0` or newer. If `cargo` is missing or too old during the wrapper build, treat the build as incomplete and rebuild after fixing Rust/Cargo instead of debugging the Codex app UI.

First proof path avoids system-wide install.

```bash
git clone <wrapper-source-url> upstream/codex-linux-wrapper
cd upstream/codex-linux-wrapper
git checkout 9125911c8347c35177dfc76e2f5bce2b8b2e41d4

# Download Codex.dmg separately, then verify:
sha256sum /path/to/Codex.dmg
# latest expected: 7de4cce5ec6e39478b9f0630e2b9257aadd1d02dd6a0fdc00c2ecdf0f536022d

make build-app DMG=/absolute/path/to/Codex.dmg
./codex-app/start.sh
```

Optional smoke check:

```bash
python3 - <<'PY'
import urllib.request
with urllib.request.urlopen('http://127.0.0.1:5175/', timeout=3) as r:
 print(r.status, r.read(80))
PY
```

## Proof metadata

| Field | Value |
| --- | --- |
| Wrapper commit | `9125911c8347c35177dfc76e2f5bce2b8b2e41d4` + local latest-DMG compatibility patches |
| Wrapper version | `0.8.2` |
| Codex app version | `26.616.41845` |
| Electron version | `42.1.0` |
| DMG size | `520180841` bytes |
| DMG SHA256 | `7de4cce5ec6e39478b9f0630e2b9257aadd1d02dd6a0fdc00c2ecdf0f536022d` |

## Evidence

```text
reports/final-validation.md              Main validation report
reports/worker-*-wrapper-audit.md        Audit notes
reports/multi-model-selection-first-pass.md First-pass proxy/config model selection notes
evidence/build/build-info.json           Generated app metadata
evidence/build/patch-report.json         Wrapper patch report
evidence/reports/wrapper-latest-compat.patch Local wrapper compatibility diff
evidence/reports/latest-upgrade-summary.json Latest upgrade summary
evidence/gui/process-evidence.txt        Electron/webview process evidence
evidence/gui/webview-smoke-result.txt    HTTP 200 webview smoke result
assets/codex-app-linux-running.png       Screenshot
```

Large/generated artifacts are intentionally ignored, including `upstream/`, `Codex.dmg`, generated app bundles, and `.gjc/state/`.

## Do not run first

Avoid these until after visual/login/project/thread/shell-approval QA passes:

```text
make bootstrap-native
make install-native
make setup-native
make update-native
make package / make install / make deb / make rpm / make pacman / make appimage
make service-enable
sudo / pkexec / systemctl / package-manager installs
```

## Known issue

If the app shows:

```text
Oops, an error has occurred
```

and logs mention a failed dynamic module fetch, the local webview server likely got stale. A clean restart fixed it during testing:

```bash
cd /path/to/codex-linux-wrapper
./codex-app/start.sh
```

## Remaining QA

Completed: build, launch smoke, loopback webview, Electron process tree, Codex app-server process evidence.

Still recommended: sign in, open a disposable project, create a thread, test shell/file approval UI.

## Security note

Codex can access local files, repositories, credentials, shell commands, plugins, browser state, and computer-use surfaces. Treat unofficial wrappers as high-trust code. Start with a disposable project and avoid native install/updater/service paths until you trust the behavior.

## Official alternatives

For supported Linux use, run Codex CLI on Linux. For the official desktop app experience with Linux files, run Codex App on macOS/Windows and connect to the Linux host over SSH.

codex-app-in-linux

codex-app-in-linux 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

codex-app-in-linux

codex-app-in-linux 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README