ordl-openex

Codex Desktop Linux-native patch and runtime workspace for Open Research and Development Laboratories (ORDL).

This repository focuses on:

• Electron app.asar import + Linux patch reapplication.
• Native Linux runtime behavior (debug menu/devtools/file-manager defaults).
• Linux screen capture and ingestion automation (GPU Screen Recorder + cleanup).

Feature floor status: 100% working natively on Linux for the validated paths listed below.

Primary Paths

• Active patch workspace:
  • /devops/ordl-openex/Modified/app_modded/app
• Primary runnable build:
  • /devops/ordl-openex/Modified/app_modded/app/out/Codex-linux-x64/Codex
• Primary launcher:
  • /opt/codex/Codex
• Archives:
  • /devops/ordl-openex/.archive

100% Working Linux-Native Feature Floor

Capability	Status	How to run
Import new app.asar into Linux patch workspace	Working	scripts/update_from_new_asar.sh <new_app.asar> [out_dir]
Reapply Linux debug/devtools/file-manager patches	Working	scripts/patch_linux_debug_menu_without_dev_flavor.mjs
Validate built JS assets after patching	Working	scripts/validate_built_js_assets.mjs
Native Linux screen recording via GPU Screen Recorder (KMS path)	Working	scripts/gsr_live_start.sh
Segmented recording + ingest + delete ingested chunks	Working	GSR_SEGMENT_SECONDS=... GSR_INGEST_CMD='...' GSR_DELETE_INGESTED=yes scripts/gsr_live_start.sh
Retention pruning for non-ingested chunks	Working	GSR_KEEP_SEGMENTS=<N> scripts/gsr_live_start.sh
User-level automation via systemd service	Working	scripts/setup_gsr_autostart.sh

Quick Start

1) Update from new package

bash /devops/ordl-openex/scripts/update_from_new_asar.sh \
  /devops/ordl-openex/incoming/codex-<version>-windows.app.asar \
  /devops/ordl-openex/Modified/app_modded/app

2) Build and run Linux package

cd /devops/ordl-openex/Modified/app_modded/app
bun install
bun run build:linux:zip
cd out/Codex-linux-x64
./Codex

3) Start native recording (single file)

/devops/ordl-openex/scripts/gsr_live_start.sh
/devops/ordl-openex/scripts/gsr_live_status.sh
/devops/ordl-openex/scripts/gsr_live_stop.sh

4) Start segmented ingest + cleanup

GSR_SEGMENT_SECONDS=5 \
GSR_SEGMENT_DIR=/tmp/gsr-live-segments \
GSR_INGEST_CMD='python3 /path/to/ingest.py "{file}"' \
GSR_DELETE_INGESTED=yes \
GSR_KEEP_SEGMENTS=2 \
/devops/ordl-openex/scripts/gsr_live_start.sh

Automation, Patch Notes, and Discoverability

• Workflow and import details: UPDATE_WORKFLOW.md
• Workspace focus file: WORK_HERE.md
• Patch notes and release log: CHANGELOG.md
• Linux-native capabilities and verification: docs/LINUX_NATIVE_FEATURES.md
• Automation guide (systemd + ingest cleanup): docs/AUTOMATION.md
• Repo discoverability/SEO playbook: docs/REPO_DISCOVERY_SEO.md

Tools, Plugins, and Skills Coverage

Bundled plugin and skill packs are shipped inside the app workspace:

• /devops/ordl-openex/Modified/app_modded/app/resources/plugins/openai-bundled/plugins

Local helper scripts in this repo automate Linux-native operations:

• scripts/update_from_new_asar.sh
• scripts/patch_linux_debug_menu_without_dev_flavor.mjs
• scripts/gsr_live_start.sh
• scripts/gsr_live_status.sh
• scripts/gsr_live_stop.sh
• scripts/gsr_live_worker.sh
• scripts/setup_gsr_autostart.sh
• scripts/seo_repo_setup.sh
• scripts/verify_linux_native_stack.sh

Search Keywords (Repo Discovery)

linux codex desktop, electron asar patching, gpu screen recorder linux, wayland kms capture, automated ingest cleanup, gsr linux automation, codex linux runtime patching, ORDL open research development laboratories.