AgentSkillsCN

launch-codex-unpacked

使用 launch_codex_unpacked.sh，以调试端口和可选的 SSH 主机自动启动方式，快速启动解压后的 Codex Desktop 构建。适用于需要从解压后的 app.asar 文件运行 Codex、启用 inspect/远程调试功能、在启动时选择 SSH 主机，或保留临时解压产物以供后续调查时使用。

SKILL.md
--- frontmatter
name: launch-codex-unpacked
description: Launch unpacked Codex Desktop builds with debug ports and optional SSH host autostart using launch_codex_unpacked.sh. Use when asked to run Codex from extracted app.asar, enable inspect/remote-debugging, select an SSH host on startup, or keep temporary unpacked artifacts for investigation.

Launch Codex Unpacked

Use this skill when the task is to run Codex Desktop from unpacked app.asar with controlled debug settings.

Primary Script

  • •./launch_codex_unpacked.sh

Preflight

Run these checks before launch:

bash
test -x ./launch_codex_unpacked.sh
test -d /Applications/Codex.app

Tooling note:

  • •The launcher auto-installs missing node/npx via Homebrew by default.
  • •Set AUTO_INSTALL_TOOLS=0 to disable auto-install behavior.

If a custom app path is provided, verify it contains:

  • •<APP_PATH>/Contents/Resources/app.asar
  • •<APP_PATH>/Contents/Resources/codex

Common Launch Recipes

Default launch (inspect + remote debugging enabled):

bash
./launch_codex_unpacked.sh

Custom ports:

bash
./launch_codex_unpacked.sh --inspect-port 9330 --remote-debug-port 9333

Disable one or both debug channels:

bash
./launch_codex_unpacked.sh --no-inspect
./launch_codex_unpacked.sh --no-remote-debug

Launch against a different Codex.app:

bash
./launch_codex_unpacked.sh --app "/Applications/Codex.app"

Preserve extracted temp app for analysis:

bash
./launch_codex_unpacked.sh --keep-temp

Use a fixed Chromium profile/user data directory:

bash
./launch_codex_unpacked.sh --user-data-dir "/tmp/codex-user-data"

SSH host autostart mode:

bash
./launch_codex_unpacked.sh --ssh-host "user@host"

What SSH mode does:

  • •Performs non-interactive SSH preflight (BatchMode + timeout).
  • •Updates ~/.codex/.codex-global-state.json (electron-ssh-hosts).
  • •Patches unpacked main bundle so startup opens the first saved SSH host.

Argument Pass-through

Append app arguments after --:

bash
./launch_codex_unpacked.sh -- --some-codex-flag value

Output You Should Report

After launch, report:

  • •App dir path
  • •User data dir path
  • •final Command line
  • •whether SSH host mode was enabled

Troubleshooting

  • •Missing app.asar or Missing codex binary: wrong --app path.
  • •SSH autostart patch anchor not found: Codex bundle changed; script patch target must be updated.
  • •SSH preflight warning: app can still launch, but remote host connection may fail in UI.