@just-every/manager 0.1.3 → 0.1.5

package/README.md

@@ -26,3 +26,4 @@ Use `--download-only` to cache the installer without launching it, and
 - `JE_AGENT_ASSET` – override the installer filename.
 - `JE_AGENT_GITHUB_TOKEN` – optional GitHub token for private releases (also supports `GH_TOKEN` / `GITHUB_TOKEN`).
 - `JE_AGENT_SKIP_DOWNLOAD=1` – skip the postinstall download/caching step.
+- `JE_AGENT_SKIP_LAUNCH=1` – skip launching the installer after download (also supports `JE_MANAGER_SKIP_LAUNCH`).

package/bin/justevery-manager.js

@@ -1,9 +1,16 @@
 #!/usr/bin/env node
 import { ensureInstaller, launchInstaller } from '../lib/installer.js';
+import { platform as osPlatform } from 'os';
 
 const args = process.argv.slice(2);
 const wantsHelp = args.includes('--help') || args.includes('-h');
-const downloadOnly = args.includes('--download-only') || args.includes('--no-open');
+const skipLaunchEnv = process.env.JE_AGENT_SKIP_LAUNCH === '1' || process.env.JE_MANAGER_SKIP_LAUNCH === '1';
+const sessionType = (process.env.XDG_SESSION_TYPE || '').toLowerCase();
+const isSsh = Boolean(process.env.SSH_CONNECTION || process.env.SSH_TTY || process.env.SSH_CLIENT);
+const hasDisplay = Boolean(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
+const hasGuiSession = Boolean(sessionType) && sessionType !== 'tty';
+const isHeadlessLinux = osPlatform() === 'linux' && (!hasDisplay || !hasGuiSession || isSsh);
+const downloadOnly = args.includes('--download-only') || args.includes('--no-open') || skipLaunchEnv || isHeadlessLinux;
 const printPath = args.includes('--print-path');
 
 if (wantsHelp) {
@@ -35,6 +42,8 @@ try {
   }
   if (!downloadOnly) {
     await launchInstaller(result.path);
+  } else if (isHeadlessLinux) {
+    console.log('No desktop session detected. Run the installer on a machine with a GUI.');
   }
 } catch (error) {
   console.error(`Failed to prepare installer: ${error.message}`);

package/lib/installer.js

@@ -316,6 +316,18 @@ function ensureExecutable(path) {
   } catch {}
 }
 
+function shouldSkipLaunch() {
+  if (process.env.JE_AGENT_SKIP_LAUNCH === '1' || process.env.JE_MANAGER_SKIP_LAUNCH === '1') {
+    return true;
+  }
+  if (osPlatform() !== 'linux') return false;
+  const hasDisplay = Boolean(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
+  const sessionType = (process.env.XDG_SESSION_TYPE || '').toLowerCase();
+  const hasGuiSession = Boolean(sessionType) && sessionType !== 'tty';
+  const isSsh = Boolean(process.env.SSH_CONNECTION || process.env.SSH_TTY || process.env.SSH_CLIENT);
+  return !hasDisplay || !hasGuiSession || isSsh;
+}
+
 export async function resolveAgentVersion() {
   if (process.env.JE_AGENT_VERSION) {
     return process.env.JE_AGENT_VERSION.trim();
@@ -366,6 +378,12 @@ export async function ensureInstaller({ allowDownload = true } = {}) {
 
 export function launchInstaller(installerPath) {
   const platform = osPlatform();
+  if (shouldSkipLaunch()) {
+    console.log('Every Manager installer downloaded. Launch skipped in this environment.');
+    console.log(`Installer path: ${installerPath}`);
+    console.log('Run the installer from a desktop session, or pass --download-only to skip launching.');
+    return Promise.resolve();
+  }
   if (platform === 'darwin') {
     return runCommand('open', [installerPath]);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@just-every/manager",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Installer wrapper for Every Manager",
   "license": "UNLICENSED",
   "type": "module",