@duanluan/codex-plus-plus-launcher 0.1.11 → 0.1.12

package/README.md

@@ -7,7 +7,7 @@ Windows 和 macOS 安装后会得到两个入口：
 - `Codex++`：静默启动入口，负责启动 Codex 并注入增强功能。
 - `Codex++ 管理工具`：上游 Tauri 控制面板，用于检查、修复、更新和管理增强功能。
 
-Linux 暂不提供上游桌面 sidecar。Linux 用户可以直接使用上游项目提供的方案，例如 Arch Linux 的 [codex-plus-plus](https://aur.archlinux.org/packages/codex-plus-plus) AUR 包。
+Linux 支持需要先安装 [ilysenko/codex-desktop-linux](https://github.com/ilysenko/codex-desktop-linux)。npm 包会内置上游 Codex++ 静默 launcher，并为 `codex-desktop-linux` 生成一个 `codex.exe` shim，让 Codex++ 可以通过 `--app-path` 启动 Linux 版 Codex Desktop；Linux 暂不内置 Codex++ 管理工具。
 
 ## 安装
 
@@ -19,7 +19,7 @@ npm install -g @duanluan/codex-plus-plus-launcher
 
 - Windows：复制到 `%LOCALAPPDATA%\Programs\Codex++`，创建桌面和开始菜单的 `Codex++`、`Codex++ 管理工具` 快捷方式。
 - macOS：优先创建 `/Applications/Codex++.app` 和 `/Applications/Codex++ 管理工具.app`，无权限时退到 `~/Applications`。
-- Linux：命令可安装，但上游桌面 sidecar 当前标记为 unsupported。
+- Linux：如果已安装 `codex-desktop-linux`，复制 `codex-plus-plus` 静默 launcher，生成 `codex.exe` shim，并创建 `~/.local/share/applications/codex-plus-plus.desktop`。如果安装 npm 包时还没装 `codex-desktop-linux`，postinstall 会跳过集成且不报错；之后运行 `cxpp install-app` 或 `cxpp repair-app` 即可补装入口。
 
 postinstall 只安装入口和快捷方式，不会自动启动 Codex++、管理工具或 Codex 进程。
 
@@ -45,6 +45,7 @@ Windows/npm 路线默认把“更新 Codex++”收敛成“更新这个 wrapper
 - `install_root`：已复制 sidecar 和入口的本机目录。
 - `silent_binary_state` / `manager_binary_state`：两个 sidecar 是否已安装。
 - `silent_entrypoint_state` / `manager_entrypoint_state`：两个桌面入口是否已安装。
+- Linux 还会显示 `linux_codex_desktop_state`、`linux_codex_desktop_start` 和 `linux_codex_shim_state`；`manager_binary_state` / `manager_entrypoint_state` 在 Linux 上为 `unsupported`。
 
 ## 本地开发验证
 
@@ -54,7 +55,7 @@ Windows/npm 路线默认把“更新 Codex++”收敛成“更新这个 wrapper
 npm run build:sidecars-local
 ```
 
-发布包验证要求 `upstream-bin/win32-x64`、`upstream-bin/darwin-x64`、`upstream-bin/darwin-arm64` 都包含上游二进制、图标和 `upstream-release.json`：
+发布包验证要求 `upstream-bin/win32-x64`、`upstream-bin/darwin-x64`、`upstream-bin/darwin-arm64` 都包含上游二进制和图标，`upstream-bin/linux-x64` 包含上游静默 launcher，并包含 `upstream-release.json`：
 
 ```bash
 npm run prepack

package/README_EN.md

@@ -7,7 +7,7 @@ Windows and macOS installs provide two entry points:
 - `Codex++`: the silent launcher entry.
 - `Codex++ Manager`: the upstream Tauri control panel for checks, repair, updates, and enhancement management.
 
-Linux does not ship the upstream desktop sidecar in this npm package yet. Linux users should use the upstream project distribution path where available, such as the Arch Linux [codex-plus-plus](https://aur.archlinux.org/packages/codex-plus-plus) AUR package.
+Linux support requires [ilysenko/codex-desktop-linux](https://github.com/ilysenko/codex-desktop-linux) to be installed first. The npm package bundles the upstream Codex++ silent launcher and generates a `codex.exe` shim for `codex-desktop-linux`, so Codex++ can launch the Linux Codex Desktop through `--app-path`; Codex++ Manager is not bundled on Linux yet.
 
 ## Install
 
@@ -19,7 +19,7 @@ The npm install adds the `cxpp`/`codexpp` commands and copies the bundled upstre
 
 - Windows: copies to `%LOCALAPPDATA%\Programs\Codex++` and creates Desktop and Start Menu shortcuts for `Codex++` and `Codex++ Manager`.
 - macOS: creates `/Applications/Codex++.app` and `/Applications/Codex++ 管理工具.app`, falling back to `~/Applications` if `/Applications` is not writable.
-- Linux: commands can be installed, but upstream desktop sidecar mode is reported as unsupported.
+- Linux: if `codex-desktop-linux` is installed, copies the `codex-plus-plus` silent launcher, generates a `codex.exe` shim, and creates `~/.local/share/applications/codex-plus-plus.desktop`. If `codex-desktop-linux` is missing during npm install, postinstall skips integration without failing; run `cxpp install-app` or `cxpp repair-app` after installing it.
 
 The postinstall step only installs entry points and shortcuts. It does not auto-launch Codex++, the manager UI, or any Codex process.
 
@@ -45,6 +45,7 @@ Important `doctor --json` fields:
 - `install_root`: the local sidecar and entrypoint install directory.
 - `silent_binary_state` / `manager_binary_state`: whether each sidecar is installed.
 - `silent_entrypoint_state` / `manager_entrypoint_state`: whether each desktop entry point is installed.
+- Linux also reports `linux_codex_desktop_state`, `linux_codex_desktop_start`, and `linux_codex_shim_state`; `manager_binary_state` / `manager_entrypoint_state` are `unsupported` on Linux.
 
 ## Local Verification
 
@@ -54,7 +55,7 @@ Build the upstream sidecars for the current platform:
 npm run build:sidecars-local
 ```
 
-Package verification expects `upstream-bin/win32-x64`, `upstream-bin/darwin-x64`, and `upstream-bin/darwin-arm64` to contain the upstream binaries, icons, and `upstream-release.json`:
+Package verification expects `upstream-bin/win32-x64`, `upstream-bin/darwin-x64`, and `upstream-bin/darwin-arm64` to contain the upstream binaries and icons, `upstream-bin/linux-x64` to contain the upstream silent launcher, and `upstream-release.json` to be present:
 
 ```bash
 npm run prepack

package/codex_plus_plus_launcher/__init__.py

@@ -1 +1 @@
-__version__ = "0.1.11"
+__version__ = "0.1.12"

package/npm/build-local-binary.cjs

@@ -27,6 +27,9 @@ function buildTargetArgs(key) {
   if (key === 'darwin-arm64') {
     return ['--target', 'aarch64-apple-darwin'];
   }
+  if (key === 'linux-x64') {
+    return [];
+  }
   return [];
 }
 
@@ -35,6 +38,10 @@ function cargoTargetForKey(key) {
   return args.length ? args[1] : '';
 }
 
+function packageBuildArgs(key) {
+  return key === 'linux-x64' ? ['-p', 'codex-plus-launcher'] : [];
+}
+
 function main() {
   const root = packageRoot();
   const upstreamDir = process.env.CODEXPP_UPSTREAM_DIR || path.join(os.tmpdir(), 'CodexPlusPlus-upstream-build');
@@ -49,20 +56,27 @@ function main() {
     run('git', ['checkout', 'FETCH_HEAD'], { cwd: upstreamDir });
   }
 
-  run('npm', ['install', '--package-lock=false'], { cwd: path.join(upstreamDir, 'apps', 'codex-plus-manager'), shell: process.platform === 'win32' });
-  run('npm', ['run', 'vite:build'], { cwd: path.join(upstreamDir, 'apps', 'codex-plus-manager'), shell: process.platform === 'win32' });
-  run('cargo', ['build', '--release', ...buildTargetArgs(key)], { cwd: upstreamDir });
+  if (key !== 'linux-x64') {
+    run('npm', ['install', '--package-lock=false'], { cwd: path.join(upstreamDir, 'apps', 'codex-plus-manager'), shell: process.platform === 'win32' });
+    run('npm', ['run', 'vite:build'], { cwd: path.join(upstreamDir, 'apps', 'codex-plus-manager'), shell: process.platform === 'win32' });
+  }
+  run('cargo', ['build', '--release', ...buildTargetArgs(key), ...packageBuildArgs(key)], { cwd: upstreamDir });
 
   const cargoTarget = cargoTargetForKey(key);
   const targetDir = path.join(upstreamDir, 'target', ...(cargoTarget ? [cargoTarget] : []), 'release');
   fs.mkdirSync(outDir, { recursive: true });
   const exe = key.startsWith('win32') ? '.exe' : '';
   fs.copyFileSync(path.join(targetDir, `codex-plus-plus${exe}`), path.join(outDir, `codex-plus-plus${exe}`));
-  fs.copyFileSync(path.join(targetDir, `codex-plus-plus-manager${exe}`), path.join(outDir, `codex-plus-plus-manager${exe}`));
+  const managerSource = path.join(targetDir, `codex-plus-plus-manager${exe}`);
+  if (fs.existsSync(managerSource)) {
+    fs.copyFileSync(managerSource, path.join(outDir, `codex-plus-plus-manager${exe}`));
+  }
   const iconSource = key.startsWith('darwin')
     ? path.join(upstreamDir, 'apps', 'codex-plus-manager', 'src-tauri', 'icons', 'icon.png')
     : path.join(upstreamDir, 'apps', 'codex-plus-manager', 'src-tauri', 'icons', 'icon.ico');
-  fs.copyFileSync(iconSource, path.join(outDir, key.startsWith('darwin') ? 'codex-plus-plus.png' : 'codex-plus-plus.ico'));
+  if (fs.existsSync(iconSource)) {
+    fs.copyFileSync(iconSource, path.join(outDir, key.startsWith('darwin') ? 'codex-plus-plus.png' : 'codex-plus-plus.ico'));
+  }
 
   const cargoToml = fs.readFileSync(path.join(upstreamDir, 'Cargo.toml'), 'utf8');
   const versionMatch = cargoToml.match(/^\s*version\s*=\s*"([^"]+)"/m);
@@ -86,4 +100,4 @@ if (require.main === module) {
   }
 }
 
-module.exports = { buildTargetArgs, cargoTargetForKey, main, platformKey };
+module.exports = { buildTargetArgs, cargoTargetForKey, main, packageBuildArgs, platformKey };

package/npm/i18n.js

@@ -3,8 +3,10 @@ const messages = {
     missingPython: '缺少命令：python3、python 或 py',
     missingBinary: '缺少随 npm 包安装的 cxpp 二进制程序',
     missingSidecar: '缺少随 npm 包内置的 Codex++ 上游程序',
+    missingLinuxCodexDesktop: '未找到 ilysenko/codex-desktop-linux 安装。请先安装 codex-desktop-linux，或设置 CODEXPP_LINUX_CODEX_START 指向 start.sh',
     missingPip: '当前 Python 缺少 pip，请先安装 pip',
     unsupportedPlatform: '当前 Codex++ 桌面版 npm 包暂不支持该平台',
+    unsupportedLinuxManager: 'Linux 暂不提供 Codex++ 管理工具；请使用 cxpp launch 启动 Codex++',
     installingWrapper: '正在安装 codex-plus-plus-launcher',
     installingCodexPlusPlus: '正在安装 Codex++',
     installDone: '安装完成',
@@ -21,8 +23,10 @@ const messages = {
     missingPython: 'missing command: python3, python, or py',
     missingBinary: 'missing bundled cxpp binary installed by the npm package',
     missingSidecar: 'missing bundled upstream Codex++ program installed by the npm package',
+    missingLinuxCodexDesktop: 'could not find an ilysenko/codex-desktop-linux install; install codex-desktop-linux first or set CODEXPP_LINUX_CODEX_START to start.sh',
     missingPip: 'pip is not available for the selected Python runtime',
     unsupportedPlatform: 'the bundled Codex++ desktop npm package does not support this platform yet',
+    unsupportedLinuxManager: 'Codex++ Manager is not bundled for Linux yet; use cxpp launch to start Codex++',
     installingWrapper: 'installing codex-plus-plus-launcher',
     installingCodexPlusPlus: 'installing Codex++',
     installDone: 'installation completed',

package/npm/launcher.js

@@ -5,11 +5,14 @@ const readline = require('node:readline');
 const { spawn, spawnSync } = require('node:child_process');
 const { t } = require('./i18n.js');
 
-const SUPPORTED_PLATFORMS = new Set(['win32-x64', 'darwin-x64', 'darwin-arm64']);
+const SUPPORTED_PLATFORMS = new Set(['win32-x64', 'darwin-x64', 'darwin-arm64', 'linux-x64']);
 const SILENT_BINARY = 'codex-plus-plus';
 const MANAGER_BINARY = 'codex-plus-plus-manager';
 const SILENT_NAME = 'Codex++';
 const MANAGER_NAME = 'Codex++ 管理工具';
+const LINUX_SHIM_DIR_NAME = 'codex-desktop-linux-shim';
+const LINUX_SHIM_BINARY = 'codex.exe';
+const LINUX_DESKTOP_ENTRY = 'codex-plus-plus.desktop';
 
 function optionValue(options, key, fallback) {
   const value = options[key];
@@ -39,6 +42,15 @@ function executableName(name, platform = process.platform) {
   return platform === 'win32' ? `${name}.exe` : name;
 }
 
+function requiredSidecarKinds(options = {}) {
+  const platform = optionValue(options, 'platform', process.platform);
+  return platform === 'linux' ? ['silent'] : ['silent', 'manager'];
+}
+
+function sidecarKindSupported(kind, options = {}) {
+  return requiredSidecarKinds(options).includes(kind);
+}
+
 function upstreamBinDir(options = {}) {
   const root = optionValue(options, 'packageRoot', packageRoot);
   const platform = optionValue(options, 'platform', process.platform);
@@ -107,7 +119,7 @@ function assertSupportedPlatform(options = {}) {
 function assertBundledSidecars(options = {}) {
   const fsImpl = options.fs || fs;
   assertSupportedPlatform(options);
-  const missing = [bundledSidecarPath('silent', options), bundledSidecarPath('manager', options)].filter((candidate) => !fsImpl.existsSync(candidate));
+  const missing = requiredSidecarKinds(options).map((kind) => bundledSidecarPath(kind, options)).filter((candidate) => !fsImpl.existsSync(candidate));
   if (missing.length > 0) {
     const error = new Error(`${t('missingSidecar', options.env || process.env)}: ${missing.join(', ')}`);
     error.code = 'CODEXPP_MISSING_SIDECAR';
@@ -136,6 +148,16 @@ function fallbackMacInstallRoot(options = {}) {
   return optionValue(options, 'fallbackInstallRoot', () => path.join(optionValue(options, 'homeDir', () => os.homedir()), 'Applications'));
 }
 
+function xdgDataHome(options = {}) {
+  const env = options.env || process.env;
+  return env.XDG_DATA_HOME || path.join(optionValue(options, 'homeDir', () => os.homedir()), '.local', 'share');
+}
+
+function xdgStateHome(options = {}) {
+  const env = options.env || process.env;
+  return env.XDG_STATE_HOME || path.join(optionValue(options, 'homeDir', () => os.homedir()), '.local', 'state');
+}
+
 function installedSidecarPath(kind, options = {}) {
   const platform = optionValue(options, 'platform', process.platform);
   const root = optionValue(options, 'installRoot', () => detectedInstallRoot(options));
@@ -162,6 +184,18 @@ function detectedInstallRoot(options = {}) {
   return requested;
 }
 
+function linuxShimRoot(options = {}) {
+  return optionValue(options, 'linuxShimRoot', () => path.join(xdgDataHome(options), 'Codex++', LINUX_SHIM_DIR_NAME));
+}
+
+function linuxEntrypointPath(options = {}) {
+  return optionValue(options, 'linuxEntrypointPath', () => path.join(xdgDataHome(options), 'applications', LINUX_DESKTOP_ENTRY));
+}
+
+function linuxInstallStatePath(options = {}) {
+  return optionValue(options, 'linuxInstallStatePath', () => path.join(xdgStateHome(options), 'codex-plus-plus-launcher', 'linux-install.json'));
+}
+
 function isPermissionError(error) {
   return error && (error.code === 'EPERM' || error.code === 'EACCES');
 }
@@ -425,7 +459,7 @@ async function installSidecars(options = {}) {
   const installRoot = installSidecarRoot(options);
   fsImpl.mkdirSync(installRoot, { recursive: true });
   const installed = {};
-  for (const kind of ['silent', 'manager']) {
+  for (const kind of requiredSidecarKinds(options)) {
     const source = bundledSidecarPath(kind, options);
     const target = installedSidecarPath(kind, { ...options, installRoot });
     await copyReplacingChangedFile(source, target, { ...options, target });
@@ -441,6 +475,293 @@ async function installSidecars(options = {}) {
   return installed;
 }
 
+function normalizeExecutablePath(candidate) {
+  return path.resolve(String(candidate || ''));
+}
+
+function linuxStartScriptFromBinary(binaryPath, options = {}) {
+  const fsImpl = options.fs || fs;
+  const normalized = normalizeExecutablePath(binaryPath);
+  const basename = path.basename(normalized);
+  const parent = path.dirname(normalized);
+  const candidates = [];
+
+  if (basename === 'start.sh') {
+    candidates.push(normalized);
+  }
+  candidates.push(path.join(parent, 'start.sh'));
+  if (basename === 'codex-desktop') {
+    candidates.push('/opt/codex-desktop/start.sh');
+    candidates.push(path.join(parent, '..', 'opt', 'codex-desktop', 'start.sh'));
+    candidates.push(path.join(parent, '..', 'opt', 'codex-desktop-linux', 'lib', 'codex-desktop-linux', 'codex-app', 'start.sh'));
+  }
+  if (normalized.includes(`${path.sep}codex-desktop-linux${path.sep}`) || normalized.includes('/codex-desktop-linux/')) {
+    candidates.push(path.join(parent, '..', 'lib', 'codex-desktop-linux', 'codex-app', 'start.sh'));
+    candidates.push(path.join(parent, '..', 'codex-app', 'start.sh'));
+  }
+
+  for (const candidate of candidates) {
+    const resolved = path.resolve(candidate);
+    if (fsImpl.existsSync(resolved)) {
+      return resolved;
+    }
+  }
+  return null;
+}
+
+function linuxStartScriptCandidates(options = {}) {
+  const env = options.env || process.env;
+  const homeDir = optionValue(options, 'homeDir', () => os.homedir());
+  const candidates = [];
+  for (const value of [env.CODEXPP_LINUX_CODEX_START, env.CODEX_DESKTOP_LINUX_START, env.CODEX_DESKTOP_START]) {
+    if (value) {
+      candidates.push(value);
+    }
+  }
+  for (const value of [env.CODEXPP_LINUX_APPDIR, env.CODEX_DESKTOP_LINUX_APPDIR, env.APPDIR]) {
+    if (value) {
+      candidates.push(path.join(value, 'opt', 'codex-desktop', 'start.sh'));
+    }
+  }
+  for (const value of [env.CODEXPP_LINUX_CODEX_BIN, env.CODEX_DESKTOP_LINUX_BIN]) {
+    if (value) {
+      const start = linuxStartScriptFromBinary(value, options);
+      if (start) {
+        candidates.push(start);
+      }
+    }
+  }
+  const which = options.which || ((name) => {
+    const result = (options.spawnSync || spawnSync)('which', [name], { encoding: 'utf8' });
+    return result.status === 0 ? String(result.stdout || '').trim().split(/\r?\n/)[0] : '';
+  });
+  for (const name of ['codex-desktop', 'openai-codex-desktop']) {
+    try {
+      const found = which(name);
+      if (found) {
+        const start = linuxStartScriptFromBinary(found, options);
+        if (start) {
+          candidates.push(start);
+        }
+      }
+    } catch (_error) {}
+  }
+  candidates.push('/opt/codex-desktop/start.sh');
+  candidates.push(path.join(homeDir, '.local', 'opt', 'codex-desktop-linux', 'lib', 'codex-desktop-linux', 'codex-app', 'start.sh'));
+  candidates.push(path.join(homeDir, 'codex-desktop-linux', 'codex-app', 'start.sh'));
+
+  const unique = [];
+  const seen = new Set();
+  for (const candidate of candidates) {
+    if (!candidate) {
+      continue;
+    }
+    const resolved = path.resolve(candidate);
+    if (!seen.has(resolved)) {
+      seen.add(resolved);
+      unique.push(resolved);
+    }
+  }
+  return unique;
+}
+
+function detectLinuxCodexDesktop(options = {}) {
+  const fsImpl = options.fs || fs;
+  for (const startScript of linuxStartScriptCandidates(options)) {
+    if (fsImpl.existsSync(startScript)) {
+      const appRoot = path.dirname(startScript);
+      return {
+        kind: 'codex-desktop-linux',
+        startScript,
+        appRoot,
+        resourcesDir: path.join(appRoot, 'resources'),
+      };
+    }
+  }
+  return null;
+}
+
+function shellSingleQuote(value) {
+  return `'${String(value).replace(/'/g, "'\\''")}'`;
+}
+
+function linuxCodexShimScript(startScript) {
+  return [
+    '#!/usr/bin/env bash',
+    'set -euo pipefail',
+    `exec ${shellSingleQuote(startScript)} -- "$@"`,
+    '',
+  ].join('\n');
+}
+
+function writeLinuxCodexShim(installation, options = {}) {
+  const fsImpl = options.fs || fs;
+  const shimRoot = linuxShimRoot(options);
+  fsImpl.mkdirSync(shimRoot, { recursive: true });
+  const shimPath = path.join(shimRoot, LINUX_SHIM_BINARY);
+  fsImpl.writeFileSync(shimPath, linuxCodexShimScript(installation.startScript), 'utf8');
+  fsImpl.chmodSync(shimPath, 0o755);
+  return { shimRoot, shimPath };
+}
+
+function linuxDesktopEntry({ name, execPath, iconPath, comment }) {
+  const iconLine = iconPath ? `Icon=${iconPath}\n` : '';
+  return `[Desktop Entry]
+Name=${name}
+Comment=${comment}
+Exec=${execPath}
+${iconLine}Terminal=false
+Type=Application
+Categories=Development;
+StartupNotify=true
+`;
+}
+
+function installLinuxEntrypoints(installed, options = {}) {
+  const fsImpl = options.fs || fs;
+  const desktopPath = linuxEntrypointPath(options);
+  fsImpl.mkdirSync(path.dirname(desktopPath), { recursive: true });
+  const command = `${desktopExecArg(installed.silent)} --app-path ${desktopExecArg(installed.linuxShimRoot)}`;
+  fsImpl.writeFileSync(
+    desktopPath,
+    linuxDesktopEntry({
+      name: SILENT_NAME,
+      execPath: command,
+      iconPath: installed.icon || '',
+      comment: 'Launch Codex++ with Codex Desktop for Linux',
+    }),
+    'utf8',
+  );
+  return {
+    silent: desktopPath,
+    manager: 'unsupported',
+  };
+}
+
+function desktopExecArg(value) {
+  const raw = String(value);
+  if (/^[A-Za-z0-9_/:=.,@%+-]+$/.test(raw)) {
+    return raw.replace(/%/g, '%%');
+  }
+  return `"${raw.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/`/g, '\\`').replace(/\$/g, '\\$').replace(/%/g, '%%')}"`;
+}
+
+function linuxShellArg(value) {
+  const raw = String(value);
+  if (/^[A-Za-z0-9_/:=.,@%+-]+$/.test(raw)) {
+    return raw;
+  }
+  return shellSingleQuote(raw);
+}
+
+function linuxHasExplicitAppPath(args) {
+  for (let index = 0; index < args.length; index += 1) {
+    if (args[index] === '--app-path' && args[index + 1]) {
+      return true;
+    }
+  }
+  return false;
+}
+
+function linuxShimPathFromRoot(root) {
+  return path.join(root, LINUX_SHIM_BINARY);
+}
+
+function linuxStateShimRoots(state) {
+  const roots = [];
+  if (state && state.codex_shim_root) {
+    roots.push(state.codex_shim_root);
+  }
+  if (state && state.codex_shim) {
+    roots.push(path.dirname(state.codex_shim));
+  }
+  return roots;
+}
+
+function ensureLinuxCodexShimRoot(options = {}) {
+  const fsImpl = options.fs || fs;
+  const state = readJsonFile(linuxInstallStatePath(options), fsImpl) || {};
+  const roots = [...linuxStateShimRoots(state), linuxShimRoot(options)];
+  const seen = new Set();
+  for (const root of roots) {
+    if (!root || seen.has(root)) {
+      continue;
+    }
+    seen.add(root);
+    if (fsImpl.existsSync(linuxShimPathFromRoot(root))) {
+      return root;
+    }
+  }
+
+  const installation = detectLinuxCodexDesktop(options);
+  if (!installation) {
+    return null;
+  }
+  const shim = writeLinuxCodexShim(installation, options);
+  const installedSilent = installedSidecarPath('silent', options);
+  const silent = fsImpl.existsSync(installedSilent) ? installedSilent : bundledSidecarPath('silent', options);
+  writeLinuxInstallState(
+    {
+      silent,
+      installRoot: path.dirname(silent),
+      linuxShim: shim.shimPath,
+      linuxShimRoot: shim.shimRoot,
+    },
+    installation,
+    options,
+  );
+  return shim.shimRoot;
+}
+
+function linuxSilentLaunchArgs(args, options = {}) {
+  if (linuxHasExplicitAppPath(args)) {
+    return args;
+  }
+  const shimRoot = ensureLinuxCodexShimRoot(options);
+  if (!shimRoot) {
+    const error = new Error(t('missingLinuxCodexDesktop', options.env || process.env));
+    error.code = 'CODEXPP_MISSING_LINUX_CODEX_DESKTOP';
+    throw error;
+  }
+  return ['--app-path', shimRoot, ...args];
+}
+
+function writeLinuxInstallState(installed, installation, options = {}) {
+  const fsImpl = options.fs || fs;
+  const statePath = linuxInstallStatePath(options);
+  fsImpl.mkdirSync(path.dirname(statePath), { recursive: true });
+  const payload = {
+    mode: 'codex_desktop_linux',
+    app_integration_state: 'installed',
+    codex_desktop_linux_start: installation.startScript,
+    codex_desktop_linux_app_root: installation.appRoot,
+    codex_shim: installed.linuxShim,
+    codex_shim_root: installed.linuxShimRoot,
+    silent_binary: installed.silent,
+    upstream_version: bundledUpstreamVersion(options) || null,
+    installed_at: new Date().toISOString(),
+  };
+  fsImpl.writeFileSync(statePath, JSON.stringify(payload, null, 2) + '\n', 'utf8');
+  return statePath;
+}
+
+async function installLinuxApp(options = {}) {
+  const installation = detectLinuxCodexDesktop(options);
+  if (!installation) {
+    const error = new Error(t('missingLinuxCodexDesktop', options.env || process.env));
+    error.code = 'CODEXPP_MISSING_LINUX_CODEX_DESKTOP';
+    throw error;
+  }
+  const installed = await installSidecars(options);
+  const shim = writeLinuxCodexShim(installation, options);
+  installed.linuxShim = shim.shimPath;
+  installed.linuxShimRoot = shim.shimRoot;
+  installed.linuxCodexStart = installation.startScript;
+  const entrypoints = await installEntrypoints(installed, { ...options, installRoot: installed.installRoot });
+  const statePath = writeLinuxInstallState(installed, installation, options);
+  return { installed, entrypoints, linux: installation, statePath };
+}
+
 function installSidecarRoot(options = {}) {
   const platform = optionValue(options, 'platform', process.platform);
   const fsImpl = options.fs || fs;
@@ -606,10 +927,17 @@ async function installEntrypoints(installed, options = {}) {
   if (platform === 'darwin') {
     return installMacEntrypoints(installed, options);
   }
+  if (platform === 'linux') {
+    return installLinuxEntrypoints(installed, options);
+  }
   return { unsupported: true };
 }
 
 async function installApp(options = {}) {
+  const platform = optionValue(options, 'platform', process.platform);
+  if (platform === 'linux') {
+    return installLinuxApp(options);
+  }
   const installed = await installSidecars(options);
   const entrypoints = await installEntrypoints(installed, { ...options, installRoot: installed.installRoot });
   return { installed, entrypoints };
@@ -641,6 +969,15 @@ function inspectEntrypoints(options = {}) {
       manager_path: fsImpl.existsSync(managerPrimary) ? managerPrimary : managerFallback,
     };
   }
+  if (platform === 'linux') {
+    const desktopPath = linuxEntrypointPath(options);
+    return {
+      silent: fsImpl.existsSync(desktopPath) ? 'installed' : 'missing',
+      manager: 'unsupported',
+      silent_path: desktopPath,
+      manager_path: '',
+    };
+  }
   return { silent: 'unsupported', manager: 'unsupported' };
 }
 
@@ -648,11 +985,12 @@ function installedSidecars(options = {}) {
   const fsImpl = options.fs || fs;
   const silent = installedSidecarPath('silent', options);
   const manager = installedSidecarPath('manager', options);
+  const managerSupported = sidecarKindSupported('manager', options);
   return {
     silent,
     manager,
     silent_state: fsImpl.existsSync(silent) ? 'installed' : 'missing',
-    manager_state: fsImpl.existsSync(manager) ? 'installed' : 'missing',
+    manager_state: managerSupported ? (fsImpl.existsSync(manager) ? 'installed' : 'missing') : 'unsupported',
   };
 }
 
@@ -663,7 +1001,7 @@ function doctorReport(options = {}) {
   const sidecars = installedSidecars(options);
   const entrypoints = inspectEntrypoints(options);
   const supported = SUPPORTED_PLATFORMS.has(platformKey(platform, arch));
-  return {
+  const report = {
     platform,
     arch,
     supported: supported ? 'yes' : 'no',
@@ -681,6 +1019,16 @@ function doctorReport(options = {}) {
     silent_entrypoint: entrypoints.silent_path || '',
     manager_entrypoint: entrypoints.manager_path || '',
   };
+  if (platform === 'linux') {
+    const linux = detectLinuxCodexDesktop(options);
+    const state = readJsonFile(linuxInstallStatePath(options), options.fs || fs) || {};
+    report.linux_codex_desktop_state = linux ? 'found' : 'missing';
+    report.linux_codex_desktop_start = (linux && linux.startScript) || state.codex_desktop_linux_start || '';
+    report.linux_codex_shim = state.codex_shim || path.join(linuxShimRoot(options), LINUX_SHIM_BINARY);
+    report.linux_codex_shim_state = (options.fs || fs).existsSync(report.linux_codex_shim) ? 'installed' : 'missing';
+    report.install_mode = state.mode || (linux ? 'codex_desktop_linux' : 'unsupported');
+  }
+  return report;
 }
 
 function printDoctor(jsonMode, options = {}) {
@@ -698,6 +1046,16 @@ function printDoctor(jsonMode, options = {}) {
 function spawnSidecar(kind, args = [], options = {}) {
   assertSupportedPlatform(options);
   const platform = optionValue(options, 'platform', process.platform);
+  if (platform === 'linux' && kind === 'manager') {
+    return { status: 1, error: new Error(t('unsupportedLinuxManager', options.env || process.env)) };
+  }
+  if (platform === 'linux' && kind === 'silent') {
+    try {
+      args = linuxSilentLaunchArgs(args, options);
+    } catch (error) {
+      return { status: 1, error };
+    }
+  }
   const cwd = options.cwd || os.homedir();
   const installed = installedSidecarPath(kind, options);
   const bundled = bundledSidecarPath(kind, options);
@@ -785,12 +1143,26 @@ async function runLauncher(args = [], options = {}) {
       }
       return { status: 1, error: new Error(message) };
     }
-    const result = await installApp(options);
+    let result;
+    try {
+      result = await installApp(options);
+    } catch (error) {
+      if (command === 'npm-postinstall' && error && error.code === 'CODEXPP_MISSING_LINUX_CODEX_DESKTOP') {
+        console.log(`install_mode=unsupported`);
+        console.log(`message=${error.message || String(error)}`);
+        return { status: 0 };
+      }
+      throw error;
+    }
     console.log(`install_mode=sidecar`);
     console.log(`upstream_version=${bundledUpstreamVersion(options) || 'missing'}`);
     console.log(`install_root=${result.installed.installRoot}`);
     console.log(`silent_binary=${result.installed.silent}`);
-    console.log(`manager_binary=${result.installed.manager}`);
+    console.log(`manager_binary=${result.installed.manager || 'unsupported'}`);
+    if (result.installed.linuxShim) {
+      console.log(`linux_codex_shim=${result.installed.linuxShim}`);
+      console.log(`linux_codex_desktop_start=${result.installed.linuxCodexStart}`);
+    }
     console.log(`entrypoints=${result.entrypoints.skipped ? 'skipped' : 'installed'}`);
     return { status: 0 };
   }

package/npm/verify-package.cjs

@@ -7,6 +7,7 @@ const REQUIRED_PLATFORMS = {
   'win32-x64': ['codex-plus-plus.exe', 'codex-plus-plus-manager.exe'],
   'darwin-x64': ['codex-plus-plus', 'codex-plus-plus-manager'],
   'darwin-arm64': ['codex-plus-plus', 'codex-plus-plus-manager'],
+  'linux-x64': ['codex-plus-plus'],
 };
 
 const REQUIRED_ICONS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duanluan/codex-plus-plus-launcher",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Install and launch Codex++ from npm",
   "bin": {
     "cxpp": "npm/cxpp.js",

package/upstream-bin/upstream-release.json

@@ -1,16 +1,16 @@
-{
-  "version": "v1.1.5",
-  "html_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/tag/v1.1.5",
-  "asset_name": "CodexPlusPlus-1.1.5-macos-arm64.dmg",
-  "asset_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-macos-arm64.dmg",
-  "windows_asset_name": "CodexPlusPlus-1.1.5-windows-x64-setup.exe",
-  "windows_asset_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-windows-x64-setup.exe",
-  "macos_x64_asset_name": "CodexPlusPlus-1.1.5-macos-x64.dmg",
-  "macos_x64_asset_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-macos-x64.dmg",
-  "macos_arm64_asset_name": "CodexPlusPlus-1.1.5-macos-arm64.dmg",
-  "macos_arm64_asset_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-macos-arm64.dmg",
-  "source_zip_url": "https://github.com/BigPizzaV3/CodexPlusPlus/archive/refs/tags/v1.1.5.zip",
-  "install_spec": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-macos-arm64.dmg",
-  "commit": "f6b69a3692e2833e29909c14164d4f6d309363b3",
-  "repository": "BigPizzaV3/CodexPlusPlus"
-}
+{
+  "version": "v1.1.5",
+  "html_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/tag/v1.1.5",
+  "asset_name": "CodexPlusPlus-1.1.5-macos-arm64.dmg",
+  "asset_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-macos-arm64.dmg",
+  "windows_asset_name": "CodexPlusPlus-1.1.5-windows-x64-setup.exe",
+  "windows_asset_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-windows-x64-setup.exe",
+  "macos_x64_asset_name": "CodexPlusPlus-1.1.5-macos-x64.dmg",
+  "macos_x64_asset_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-macos-x64.dmg",
+  "macos_arm64_asset_name": "CodexPlusPlus-1.1.5-macos-arm64.dmg",
+  "macos_arm64_asset_url": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-macos-arm64.dmg",
+  "source_zip_url": "https://github.com/BigPizzaV3/CodexPlusPlus/archive/refs/tags/v1.1.5.zip",
+  "install_spec": "https://github.com/BigPizzaV3/CodexPlusPlus/releases/download/v1.1.5/CodexPlusPlus-1.1.5-macos-arm64.dmg",
+  "commit": "f6b69a3692e2833e29909c14164d4f6d309363b3",
+  "repository": "BigPizzaV3/CodexPlusPlus"
+}