openfox 2.0.100 → 2.0.102

package/dist/{orchestrator-DHBU7LRB.js → orchestrator-QDXKDLOW.js}

@@ -1,41 +1,42 @@
 import {
   runAgentTurn,
   runChatTurn
-} from "./chunk-CFTT46KH.js";
-import "./chunk-MO3GJIT3.js";
+} from "./chunk-QL2G5UWE.js";
+import "./chunk-Z753S3X7.js";
+import "./chunk-DPRJYQ5U.js";
+import "./chunk-MGKS2NG2.js";
+import {
+  TurnMetrics,
+  createChatDoneEvent,
+  createMessageDoneEvent,
+  createMessageStartEvent,
+  createToolCallEvent,
+  createToolResultEvent
+} from "./chunk-5ZJYEINJ.js";
+import "./chunk-4Z2ARCY3.js";
 import "./chunk-ZASSAZ73.js";
-import "./chunk-HAFRPV7I.js";
+import "./chunk-KLK5N4OX.js";
 import "./chunk-I72ACQ6R.js";
-import "./chunk-NWO6GRYE.js";
+import "./chunk-JE7LW7Y6.js";
 import "./chunk-VKWVPQJ5.js";
 import "./chunk-D3SXT3BL.js";
 import "./chunk-J7GAZGZT.js";
-import "./chunk-IXFEXEUL.js";
-import "./chunk-KQPDU65K.js";
-import "./chunk-XLI6PDJG.js";
-import "./chunk-G5JFKTSR.js";
+import "./chunk-7HIJP4PC.js";
+import "./chunk-ZLCPNTRT.js";
+import "./chunk-WPCYFH6X.js";
 import "./chunk-27SDWNKL.js";
 import "./chunk-EU3WWTFH.js";
+import "./chunk-KKEBXFB3.js";
+import "./chunk-W5FTCTGY.js";
 import "./chunk-WWFH5GAR.js";
-import {
-  TurnMetrics,
-  createChatDoneEvent,
-  createMessageDoneEvent,
-  createMessageStartEvent,
-  createToolCallEvent,
-  createToolResultEvent
-} from "./chunk-AY37NB76.js";
-import "./chunk-MRWR3SIT.js";
-import "./chunk-KNYPBXPW.js";
-import "./chunk-NLN5LPQ4.js";
-import "./chunk-O2PLNJIU.js";
-import "./chunk-ZIMGU5ZH.js";
-import "./chunk-3LRYZ7R3.js";
+import "./chunk-2EYTYXWN.js";
+import "./chunk-RZC6DAT2.js";
+import "./chunk-FQS7A5M4.js";
 import "./chunk-J2GP3J3X.js";
 import "./chunk-V4IE7HJY.js";
 import "./chunk-YHEQTVFV.js";
-import "./chunk-UIK6GA3P.js";
-import "./chunk-UEOEA6BB.js";
+import "./chunk-KCED2X4H.js";
+import "./chunk-YZSBJUGC.js";
 import "./chunk-GLF65XDS.js";
 import "./chunk-K44MW7JJ.js";
 import "./chunk-4R7G5JB6.js";
@@ -52,4 +53,4 @@ export {
   runAgentTurn,
   runChatTurn
 };
-//# sourceMappingURL=orchestrator-DHBU7LRB.js.map
+//# sourceMappingURL=orchestrator-QDXKDLOW.js.map

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfox",
-  "version": "2.0.100",
+  "version": "2.0.102",
   "description": "Local-LLM-first agentic coding assistant",
   "type": "module",
   "bin": {

package/dist/{path-security-6GYETPWN.js → path-security-SUFEIBTC.js}

@@ -19,13 +19,13 @@ import {
   providePathConfirmation,
   registerPathConfirmation,
   requestPathAccess
-} from "./chunk-G5JFKTSR.js";
+} from "./chunk-ZLCPNTRT.js";
+import "./chunk-WPCYFH6X.js";
 import "./chunk-27SDWNKL.js";
-import "./chunk-KNYPBXPW.js";
-import "./chunk-O2PLNJIU.js";
-import "./chunk-ZIMGU5ZH.js";
-import "./chunk-3LRYZ7R3.js";
-import "./chunk-UEOEA6BB.js";
+import "./chunk-2EYTYXWN.js";
+import "./chunk-RZC6DAT2.js";
+import "./chunk-FQS7A5M4.js";
+import "./chunk-YZSBJUGC.js";
 import "./chunk-GLF65XDS.js";
 import "./chunk-K44MW7JJ.js";
 import "./chunk-4R7G5JB6.js";
@@ -53,4 +53,4 @@ export {
   registerPathConfirmation,
   requestPathAccess
 };
-//# sourceMappingURL=path-security-6GYETPWN.js.map
+//# sourceMappingURL=path-security-SUFEIBTC.js.map

package/dist/{platform-7KXP3VVA.js → platform-2RLL7RAE.js}

@@ -5,8 +5,8 @@ import {
   isAbsolutePath,
   isWindowsPath,
   listAvailableShells
-} from "./chunk-NLN5LPQ4.js";
-import "./chunk-UEOEA6BB.js";
+} from "./chunk-KKEBXFB3.js";
+import "./chunk-YZSBJUGC.js";
 import "./chunk-GLF65XDS.js";
 import "./chunk-K44MW7JJ.js";
 import "./chunk-5WRI5ZAA.js";
@@ -18,4 +18,4 @@ export {
   isWindowsPath,
   listAvailableShells
 };
-//# sourceMappingURL=platform-7KXP3VVA.js.map
+//# sourceMappingURL=platform-2RLL7RAE.js.map

package/dist/{processor-RC3IBY2J.js → processor-YWNLWAZW.js}

@@ -2,38 +2,39 @@ import {
   buildRunChatTurnParams,
   finalizeTurnCompletion,
   generateSessionNameForSession
-} from "./chunk-E2CSSHSI.js";
-import "./chunk-MO3GJIT3.js";
+} from "./chunk-W5RC44R6.js";
+import "./chunk-DPRJYQ5U.js";
+import "./chunk-MGKS2NG2.js";
+import "./chunk-5ZJYEINJ.js";
+import "./chunk-4Z2ARCY3.js";
 import "./chunk-ZASSAZ73.js";
-import "./chunk-HAFRPV7I.js";
+import "./chunk-KLK5N4OX.js";
 import "./chunk-I72ACQ6R.js";
-import "./chunk-NWO6GRYE.js";
+import "./chunk-JE7LW7Y6.js";
 import "./chunk-VKWVPQJ5.js";
 import "./chunk-D3SXT3BL.js";
 import "./chunk-J7GAZGZT.js";
-import "./chunk-KQPDU65K.js";
-import "./chunk-XLI6PDJG.js";
-import "./chunk-G5JFKTSR.js";
+import "./chunk-7HIJP4PC.js";
+import "./chunk-ZLCPNTRT.js";
+import {
+  getEventStore
+} from "./chunk-WPCYFH6X.js";
 import {
   createChatMessageMessage,
   createSessionRunningMessage
 } from "./chunk-27SDWNKL.js";
 import "./chunk-EU3WWTFH.js";
+import "./chunk-KKEBXFB3.js";
+import "./chunk-W5FTCTGY.js";
 import "./chunk-WWFH5GAR.js";
-import "./chunk-AY37NB76.js";
-import "./chunk-MRWR3SIT.js";
-import {
-  getEventStore
-} from "./chunk-KNYPBXPW.js";
-import "./chunk-NLN5LPQ4.js";
-import "./chunk-O2PLNJIU.js";
-import "./chunk-ZIMGU5ZH.js";
-import "./chunk-3LRYZ7R3.js";
+import "./chunk-2EYTYXWN.js";
+import "./chunk-RZC6DAT2.js";
+import "./chunk-FQS7A5M4.js";
 import "./chunk-J2GP3J3X.js";
 import "./chunk-V4IE7HJY.js";
 import "./chunk-YHEQTVFV.js";
-import "./chunk-UIK6GA3P.js";
-import "./chunk-UEOEA6BB.js";
+import "./chunk-KCED2X4H.js";
+import "./chunk-YZSBJUGC.js";
 import "./chunk-GLF65XDS.js";
 import {
   logger
@@ -185,7 +186,7 @@ var QueueProcessor = class {
       backend: provider?.backend ?? llmClient.getBackend(),
       model: llmClient.getModel()
     };
-    const { runChatTurn } = await import("./orchestrator-DHBU7LRB.js");
+    const { runChatTurn } = await import("./orchestrator-QDXKDLOW.js");
     const runChatTurnParams = buildRunChatTurnParams({
       sessionManager,
       sessionId,
@@ -233,4 +234,4 @@ var QueueProcessor = class {
 export {
   QueueProcessor
 };
-//# sourceMappingURL=processor-RC3IBY2J.js.map
+//# sourceMappingURL=processor-YWNLWAZW.js.map

package/dist/{provider-PEJ27FBM.js → provider-FX3QCGAF.js}

@@ -11,15 +11,15 @@ import {
 import {
   detectModel,
   fetchAvailableModelsFromBackend
-} from "./chunk-W77HIJGH.js";
+} from "./chunk-AI27N57J.js";
 import "./chunk-J2GP3J3X.js";
-import "./chunk-VJILJ22N.js";
+import "./chunk-BJDQPILB.js";
 import "./chunk-V4IE7HJY.js";
 import "./chunk-YHEQTVFV.js";
 import "./chunk-HNCM3D7Y.js";
-import "./chunk-UIK6GA3P.js";
-import "./chunk-TDHDLDGQ.js";
-import "./chunk-UEOEA6BB.js";
+import "./chunk-KCED2X4H.js";
+import "./chunk-MR7ZEGOF.js";
+import "./chunk-YZSBJUGC.js";
 import "./chunk-GLF65XDS.js";
 import "./chunk-K44MW7JJ.js";
 import {
@@ -398,4 +398,4 @@ export {
   runProviderRemove,
   runProviderUse
 };
-//# sourceMappingURL=provider-PEJ27FBM.js.map
+//# sourceMappingURL=provider-FX3QCGAF.js.map

package/dist/{provider-manager-EJGPSLOZ.js → provider-manager-GLG6BA32.js}

@@ -3,15 +3,15 @@ import {
   fetchAvailableModelsFromBackend,
   fetchModelsWithContext,
   parseDefaultModelSelection
-} from "./chunk-W77HIJGH.js";
+} from "./chunk-AI27N57J.js";
 import "./chunk-J2GP3J3X.js";
-import "./chunk-VJILJ22N.js";
+import "./chunk-BJDQPILB.js";
 import "./chunk-V4IE7HJY.js";
 import "./chunk-YHEQTVFV.js";
 import "./chunk-HNCM3D7Y.js";
-import "./chunk-UIK6GA3P.js";
-import "./chunk-TDHDLDGQ.js";
-import "./chunk-UEOEA6BB.js";
+import "./chunk-KCED2X4H.js";
+import "./chunk-MR7ZEGOF.js";
+import "./chunk-YZSBJUGC.js";
 import "./chunk-GLF65XDS.js";
 import "./chunk-K44MW7JJ.js";
 import "./chunk-5WRI5ZAA.js";
@@ -21,4 +21,4 @@ export {
   fetchModelsWithContext,
   parseDefaultModelSelection
 };
-//# sourceMappingURL=provider-manager-EJGPSLOZ.js.map
+//# sourceMappingURL=provider-manager-GLG6BA32.js.map

package/dist/{registry-QEOTM3IG.js → registry-GBNLVWYQ.js}

@@ -17,8 +17,8 @@ import {
   resolveDefaultAgentId,
   saveAgent,
   saveAgentToProject
-} from "./chunk-3LRYZ7R3.js";
-import "./chunk-UEOEA6BB.js";
+} from "./chunk-FQS7A5M4.js";
+import "./chunk-YZSBJUGC.js";
 import "./chunk-GLF65XDS.js";
 import "./chunk-K44MW7JJ.js";
 import "./chunk-CQGTEGKL.js";
@@ -43,4 +43,4 @@ export {
   saveAgent,
   saveAgentToProject
 };
-//# sourceMappingURL=registry-QEOTM3IG.js.map
+//# sourceMappingURL=registry-GBNLVWYQ.js.map

package/dist/{serve-BBVBUYMU.js → serve-RKHLNGEV.js}

@@ -1,47 +1,48 @@
 import {
   createServer
-} from "./chunk-FXRZFIDX.js";
-import "./chunk-C6QW2IDH.js";
+} from "./chunk-6ZV3NYEE.js";
+import "./chunk-K6VVTE6C.js";
 import "./chunk-62QCBNPE.js";
-import "./chunk-E2CSSHSI.js";
-import "./chunk-CFTT46KH.js";
-import "./chunk-MO3GJIT3.js";
+import "./chunk-W5RC44R6.js";
+import "./chunk-QL2G5UWE.js";
+import "./chunk-Z753S3X7.js";
+import "./chunk-73EV6QYX.js";
+import "./chunk-DPRJYQ5U.js";
+import "./chunk-MGKS2NG2.js";
+import "./chunk-5ZJYEINJ.js";
+import "./chunk-4Z2ARCY3.js";
 import "./chunk-ZASSAZ73.js";
-import "./chunk-HAFRPV7I.js";
+import "./chunk-KLK5N4OX.js";
 import "./chunk-I72ACQ6R.js";
-import "./chunk-NWO6GRYE.js";
+import "./chunk-JE7LW7Y6.js";
 import "./chunk-VKWVPQJ5.js";
 import "./chunk-D3SXT3BL.js";
 import "./chunk-J7GAZGZT.js";
-import "./chunk-IXFEXEUL.js";
-import "./chunk-KQPDU65K.js";
-import "./chunk-XLI6PDJG.js";
-import "./chunk-G5JFKTSR.js";
+import "./chunk-7HIJP4PC.js";
+import "./chunk-ZLCPNTRT.js";
+import "./chunk-WPCYFH6X.js";
 import "./chunk-27SDWNKL.js";
 import "./chunk-EU3WWTFH.js";
+import "./chunk-KKEBXFB3.js";
+import "./chunk-W5FTCTGY.js";
 import "./chunk-WWFH5GAR.js";
-import "./chunk-XTKLA4AK.js";
-import "./chunk-AY37NB76.js";
-import "./chunk-MRWR3SIT.js";
-import "./chunk-KNYPBXPW.js";
-import "./chunk-NLN5LPQ4.js";
 import {
   VERSION
-} from "./chunk-T3PLCTNA.js";
-import "./chunk-O2PLNJIU.js";
-import "./chunk-ZIMGU5ZH.js";
+} from "./chunk-SV3I2YNO.js";
+import "./chunk-2EYTYXWN.js";
+import "./chunk-RZC6DAT2.js";
 import {
   loadConfig
-} from "./chunk-3LRYZ7R3.js";
-import "./chunk-W77HIJGH.js";
+} from "./chunk-FQS7A5M4.js";
+import "./chunk-AI27N57J.js";
 import "./chunk-J2GP3J3X.js";
-import "./chunk-VJILJ22N.js";
+import "./chunk-BJDQPILB.js";
 import "./chunk-V4IE7HJY.js";
 import "./chunk-YHEQTVFV.js";
 import "./chunk-HNCM3D7Y.js";
-import "./chunk-UIK6GA3P.js";
-import "./chunk-TDHDLDGQ.js";
-import "./chunk-UEOEA6BB.js";
+import "./chunk-KCED2X4H.js";
+import "./chunk-MR7ZEGOF.js";
+import "./chunk-YZSBJUGC.js";
 import "./chunk-GLF65XDS.js";
 import {
   logger
@@ -219,4 +220,4 @@ async function runServe(options) {
 export {
   runServe
 };
-//# sourceMappingURL=serve-BBVBUYMU.js.map
+//# sourceMappingURL=serve-RKHLNGEV.js.map

package/dist/server/index.d.ts

@@ -321,6 +321,19 @@ declare class SessionManager {
     private switchLocks;
     private workspaceCreationLocks;
     constructor(providerManager: ProviderManager);
+    getProviderManager(): ProviderManager;
+    /**
+     * Create an LLM client for a specific agent, respecting its model override.
+     *
+     * If the agent has a model override stored in settings, creates a dedicated
+     * client for that provider+model. Falls back to the global client if no
+     * override is set or the provider no longer exists.
+     *
+     * @param preferredFallback - When provided, used as fallback instead of
+     *   providerManager.getLLMClient(). This is important in mock/test mode
+     *   where the caller already has a mock client that should be preserved.
+     */
+    createClientForAgent(agentId: string, preferredFallback?: LLMClientWithModel): LLMClientWithModel;
     getCurrentModelSettings(sessionId?: string): {
         temperature?: number;
         topP?: number;
@@ -629,6 +642,7 @@ interface ToolContext {
     lspManager?: LspManagerInterface | undefined;
     llmClient?: LLMClientWithModel | undefined;
     statsIdentity?: StatsIdentity | undefined;
+    providerManager?: ProviderManager | undefined;
     permittedActions?: Record<string, string[]> | undefined;
     toolCallId?: string;
     agentTimeout?: number;
@@ -638,6 +652,7 @@ interface Tool {
     definition: LLMToolDefinition;
     execute: (args: Record<string, unknown>, context: ToolContext) => Promise<ToolResult>;
     permittedActions?: string[];
+    mcpServer?: string;
 }
 interface ToolRegistry {
     tools: Tool[];

package/dist/server/index.js

@@ -1,44 +1,45 @@
 import {
   createServer,
   createServerHandle
-} from "../chunk-FXRZFIDX.js";
-import "../chunk-C6QW2IDH.js";
+} from "../chunk-6ZV3NYEE.js";
+import "../chunk-K6VVTE6C.js";
 import "../chunk-62QCBNPE.js";
-import "../chunk-E2CSSHSI.js";
-import "../chunk-CFTT46KH.js";
-import "../chunk-MO3GJIT3.js";
+import "../chunk-W5RC44R6.js";
+import "../chunk-QL2G5UWE.js";
+import "../chunk-Z753S3X7.js";
+import "../chunk-73EV6QYX.js";
+import "../chunk-DPRJYQ5U.js";
+import "../chunk-MGKS2NG2.js";
+import "../chunk-5ZJYEINJ.js";
+import "../chunk-4Z2ARCY3.js";
 import "../chunk-ZASSAZ73.js";
-import "../chunk-HAFRPV7I.js";
+import "../chunk-KLK5N4OX.js";
 import "../chunk-I72ACQ6R.js";
-import "../chunk-NWO6GRYE.js";
+import "../chunk-JE7LW7Y6.js";
 import "../chunk-VKWVPQJ5.js";
 import "../chunk-D3SXT3BL.js";
 import "../chunk-J7GAZGZT.js";
-import "../chunk-IXFEXEUL.js";
-import "../chunk-KQPDU65K.js";
-import "../chunk-XLI6PDJG.js";
-import "../chunk-G5JFKTSR.js";
+import "../chunk-7HIJP4PC.js";
+import "../chunk-ZLCPNTRT.js";
+import "../chunk-WPCYFH6X.js";
 import "../chunk-27SDWNKL.js";
 import "../chunk-EU3WWTFH.js";
+import "../chunk-KKEBXFB3.js";
+import "../chunk-W5FTCTGY.js";
 import "../chunk-WWFH5GAR.js";
-import "../chunk-XTKLA4AK.js";
-import "../chunk-AY37NB76.js";
-import "../chunk-MRWR3SIT.js";
-import "../chunk-KNYPBXPW.js";
-import "../chunk-NLN5LPQ4.js";
-import "../chunk-T3PLCTNA.js";
-import "../chunk-O2PLNJIU.js";
-import "../chunk-ZIMGU5ZH.js";
-import "../chunk-3LRYZ7R3.js";
-import "../chunk-W77HIJGH.js";
+import "../chunk-SV3I2YNO.js";
+import "../chunk-2EYTYXWN.js";
+import "../chunk-RZC6DAT2.js";
+import "../chunk-FQS7A5M4.js";
+import "../chunk-AI27N57J.js";
 import "../chunk-J2GP3J3X.js";
-import "../chunk-VJILJ22N.js";
+import "../chunk-BJDQPILB.js";
 import "../chunk-V4IE7HJY.js";
 import "../chunk-YHEQTVFV.js";
 import "../chunk-HNCM3D7Y.js";
-import "../chunk-UIK6GA3P.js";
-import "../chunk-TDHDLDGQ.js";
-import "../chunk-UEOEA6BB.js";
+import "../chunk-KCED2X4H.js";
+import "../chunk-MR7ZEGOF.js";
+import "../chunk-YZSBJUGC.js";
 import "../chunk-GLF65XDS.js";
 import "../chunk-K44MW7JJ.js";
 import "../chunk-VUQCQXXJ.js";

package/dist/server-QGQGSHW6.js

@@ -0,0 +1,47 @@
+import {
+  createWebSocketServer,
+  signalMcpReady
+} from "./chunk-K6VVTE6C.js";
+import "./chunk-W5RC44R6.js";
+import "./chunk-QL2G5UWE.js";
+import "./chunk-Z753S3X7.js";
+import "./chunk-73EV6QYX.js";
+import "./chunk-DPRJYQ5U.js";
+import "./chunk-MGKS2NG2.js";
+import "./chunk-5ZJYEINJ.js";
+import "./chunk-4Z2ARCY3.js";
+import "./chunk-ZASSAZ73.js";
+import "./chunk-KLK5N4OX.js";
+import "./chunk-I72ACQ6R.js";
+import "./chunk-JE7LW7Y6.js";
+import "./chunk-VKWVPQJ5.js";
+import "./chunk-D3SXT3BL.js";
+import "./chunk-J7GAZGZT.js";
+import "./chunk-7HIJP4PC.js";
+import "./chunk-ZLCPNTRT.js";
+import "./chunk-WPCYFH6X.js";
+import "./chunk-27SDWNKL.js";
+import "./chunk-EU3WWTFH.js";
+import "./chunk-KKEBXFB3.js";
+import "./chunk-W5FTCTGY.js";
+import "./chunk-WWFH5GAR.js";
+import "./chunk-2EYTYXWN.js";
+import "./chunk-RZC6DAT2.js";
+import "./chunk-FQS7A5M4.js";
+import "./chunk-J2GP3J3X.js";
+import "./chunk-V4IE7HJY.js";
+import "./chunk-YHEQTVFV.js";
+import "./chunk-KCED2X4H.js";
+import "./chunk-YZSBJUGC.js";
+import "./chunk-GLF65XDS.js";
+import "./chunk-K44MW7JJ.js";
+import "./chunk-VUQCQXXJ.js";
+import "./chunk-4R7G5JB6.js";
+import "./chunk-B56G5OEF.js";
+import "./chunk-CQGTEGKL.js";
+import "./chunk-5WRI5ZAA.js";
+export {
+  createWebSocketServer,
+  signalMcpReady
+};
+//# sourceMappingURL=server-QGQGSHW6.js.map

package/dist/{service-2PW2V25M.js → service-CXWJQFOZ.js}

@@ -42,14 +42,7 @@ function exec(command, args = []) {
     child.on("error", reject);
   });
 }
-async function createWrapperScript() {
-  const binDir = expandPath("~/.local/state/openfox/bin");
-  await mkdir(binDir, { recursive: true });
-  const scriptPath = expandPath(RUN_SCRIPT_PATH);
-  const scriptContent = `#!/bin/bash
-source ~/.profile 2>/dev/null || true
-source ~/.bashrc 2>/dev/null || true
-
+var DISPLAY_POLLING_BLOCK = `
 if [ -z "$DISPLAY" ] || [ -z "$WAYLAND_DISPLAY" ]; then
   for _ in 0 1 2 3 4; do
     if [ -z "$DISPLAY" ]; then
@@ -77,7 +70,34 @@ if [ -z "$DISPLAY" ] || [ -z "$WAYLAND_DISPLAY" ]; then
     sleep 2
   done
 fi
-
+`;
+async function detectHeadless() {
+  if (process.env["DISPLAY"] || process.env["WAYLAND_DISPLAY"]) {
+    return false;
+  }
+  try {
+    await access("/tmp/.X11-unix/X0", constants.F_OK);
+    return false;
+  } catch {
+  }
+  const runtimeDir = process.env["XDG_RUNTIME_DIR"];
+  if (runtimeDir) {
+    try {
+      await access(join(runtimeDir, "wayland-0"), constants.F_OK);
+      return false;
+    } catch {
+    }
+  }
+  return true;
+}
+async function createWrapperScript(headless) {
+  const binDir = expandPath("~/.local/state/openfox/bin");
+  await mkdir(binDir, { recursive: true });
+  const scriptPath = expandPath(RUN_SCRIPT_PATH);
+  const scriptContent = `#!/bin/bash
+source ~/.profile 2>/dev/null || true
+source ~/.bashrc 2>/dev/null || true
+${headless ? "" : DISPLAY_POLLING_BLOCK}
 # Find openfox - respect user's PATH, fallback to nvm search for non-interactive cases
 if ! openfox_bin=$(which openfox 2>/dev/null); then
   openfox_bindir=""
@@ -102,14 +122,15 @@ exec "$openfox_bin" "$@"
   await exec("chmod", ["+x", scriptPath]);
   console.log(`Created: ${scriptPath}`);
 }
-async function createSystemdService() {
+async function createSystemdService(headless) {
   const serviceDir = expandPath("~/.config/systemd/user");
   await mkdir(serviceDir, { recursive: true });
+  const target = headless ? "default.target" : "graphical-session.target";
+  const wants = headless ? "" : "\nWants=graphical-session.target";
   const servicePath = expandPath(SERVICE_PATH);
   const serviceContent = `[Unit]
 Description=OpenFox Agentic Coding Assistant
-After=graphical-session.target
-Wants=graphical-session.target
+After=${target}${wants}
 
 [Service]
 Type=simple
@@ -120,7 +141,7 @@ KillMode=control-group
 Environment=OPENFOX_SERVICE=true
 
 [Install]
-WantedBy=graphical-session.target
+WantedBy=${target}
 `;
   await writeFile(servicePath, serviceContent, "utf-8");
   console.log(`Created: ${servicePath}`);
@@ -135,10 +156,22 @@ async function runServiceCommand(_mode, subcommand, ...args) {
     printServiceHelp();
     return;
   }
+  const headlessFlag = args.includes("--headless");
+  const desktopFlag = args.includes("--desktop");
   switch (subcommand) {
-    case "install":
-      await serviceInstall();
+    case "install": {
+      let headlessOverride;
+      if (headlessFlag && desktopFlag) {
+        console.error("Cannot use both --headless and --desktop");
+        process.exit(1);
+      } else if (headlessFlag) {
+        headlessOverride = true;
+      } else if (desktopFlag) {
+        headlessOverride = false;
+      }
+      await serviceInstall(headlessOverride);
       break;
+    }
     case "start":
       await serviceStart();
       break;
@@ -172,6 +205,8 @@ Usage:
 
 Commands:
   install    Install and enable the systemd service
+             Use --headless for headless/CLI-only servers
+             Use --desktop to force desktop mode (default when display detected)
   start      Start the service (if installed)
   stop       Stop the service (if installed)
   restart    Restart the service (if installed)
@@ -180,8 +215,14 @@ Commands:
   uninstall  Disable and remove the service files
 `);
 }
-async function serviceInstall() {
-  console.log("Installing OpenFox service...\n");
+async function serviceInstall(headlessOverride) {
+  const headless = headlessOverride ?? await detectHeadless();
+  if (headless) {
+    console.log("Installing OpenFox service (headless mode)...\n");
+  } else {
+    console.log("Installing OpenFox service (desktop mode)...\n");
+    console.log("  Tip: Use --headless for headless/CLI-only servers");
+  }
   const installed = await pathExists(SERVICE_PATH);
   if (installed) {
     const { success } = systemctl(["is-active", SERVICE_NAME], true);
@@ -192,8 +233,8 @@ async function serviceInstall() {
     console.log("Service files exist. Reinstalling...");
     await serviceUninstall();
   }
-  await createWrapperScript();
-  await createSystemdService();
+  await createWrapperScript(headless);
+  await createSystemdService(headless);
   systemctl(["daemon-reload"]);
   systemctl(["enable", SERVICE_NAME]);
   systemctl(["start", SERVICE_NAME]);
@@ -294,6 +335,7 @@ async function serviceUninstall() {
   console.log("\n\u2713 Service uninstalled");
 }
 export {
+  detectHeadless,
   runServiceCommand
 };
-//# sourceMappingURL=service-2PW2V25M.js.map
+//# sourceMappingURL=service-CXWJQFOZ.js.map