project-compass 2.7.1 → 2.8.1

package/README.md

@@ -1,4 +1,4 @@
-# Project Compass (v2.6.0)
+# Project Compass (v2.8.0)
 
 Project Compass is a futuristic CLI navigator built with [Ink](https://github.com/vadimdemedes/ink) that scans your current folder tree for familiar code projects and gives you one-keystroke access to build, test, or run them.
 
@@ -9,6 +9,7 @@ Project Compass is a futuristic CLI navigator built with [Ink](https://github.co
 - 🚀 **New Keyboard-Centric UX**: Shortcuts now use **Shift** instead of Ctrl to avoid terminal interference.
 - 💡 **Refined Output**: Improved stdin buffer with proper spacing and reliable scrolling (Shift+↑/↓).
 - 🧠 **Smart Detection**: Support for 20+ frameworks including **Spring Boot** (Maven/Gradle), **ASP.NET Core**, **Rocket/Actix** (Rust), **Laravel** (PHP), **Vite**, **Prisma**, and more.
+- 🛰️ **Orbit Task Manager**: Run commands and **Detach** (**Shift+D**) them to the background. Manage multiple processes via **Shift+T**.
 - ⚠️ **Runtime Health**: Automatically checks if the required language/runtime (e.g., `node`, `python`, `cargo`) is installed and warns you if it's missing.
 - 💎 **Omni-Studio**: A new interactive environment intelligence mode to see all installed runtimes and versions.
 - 📂 **Log Management**: Clear output with **Shift+X** or export logs to a text file with **Shift+E**.
@@ -33,11 +34,13 @@ project-compass [--dir /path/to/workspace] [--studio]
 | ↑ / ↓ | Move focus, **Enter**: toggle details |
 | B / T / R | Build / Test / Run |
 | 1‑9 | Execute numbered detail commands |
+| **Shift+T** | Open **Orbit Task Manager** |
+| **Shift+D** | **Detach** from active task (runs in background) |
 | **Shift+A** | Open **Omni-Studio** (Environment View) |
 | **Shift+C** | Add a custom command (`label|cmd`) |
 | **Shift+X** | **Clear output logs** |
 | **Shift+E** | **Export logs to .txt** |
-| **Shift ↑ / ↓** | Scroll output buffer (Intuitive Direction) |
+| **Shift ↑ / ↓** | Scroll output buffer |
 | **Shift+L** | Rerun last command |
 | **Shift+H** | Toggle help cards |
 | **Shift+S** | Toggle structure guide |
@@ -45,23 +48,13 @@ project-compass [--dir /path/to/workspace] [--studio]
 | ? | Toggle help overlay |
 | Ctrl+C | Interrupt running command |
 
-## Omni-Studio
-
-Launch with `project-compass --studio` or press **Shift+A** inside the app. Omni-Studio provides real-time intelligence on your installed development environments, checking versions for Node, Python, Rust, Go, Java, and more. 
+## Orbit Task Manager
 
-## Layout & UX
+Project Compass v2.8 introduces background task management. You can start a build, press **Shift+D** to detach and return to the navigator, then start another task. Switch between them or view logs via the Task Manager (**Shift+T**).
 
-Project Compass features a split layout where Projects and Details stay paired while Output takes a full-width band. The stdin buffer (at the bottom) now has a clear distinction between the label and your input for better readability. The help cards (Shift+H) have been refactored for a cleaner, more readable look.
-
-## Frameworks
+## Omni-Studio
 
-Supports a wide array of modern stacks:
-- **Node.js**: Next.js, React, Vue, NestJS, Vite, Prisma, Tailwind
-- **Python**: FastAPI, Django, Flask
-- **Java/Kotlin**: Spring Boot (Maven & Gradle)
-- **Rust**: Rocket, Actix Web
-- **.NET**: ASP.NET Core
-- **PHP**: Laravel
+Launch with `project-compass --studio` or press **Shift+A** inside the app. Omni-Studio provides real-time intelligence on your installed development environments, checking versions for Node, Python, Rust, Go, Java, and more. 
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-compass",
-  "version": "2.7.1",
+  "version": "2.8.1",
   "description": "Ink-based project explorer that detects local repos and lets you build/test/run them without memorizing commands.",
   "main": "src/cli.js",
   "type": "module",

package/src/cli.js

@@ -6,7 +6,7 @@ import fs from 'fs';
 import kleur from 'kleur';
 import {execa} from 'execa';
 import {discoverProjects, SCHEMA_GUIDE, checkBinary} from './projectDetection.js';
-import {CONFIG_PATH, PLUGIN_FILE, ensureConfigDir} from './configPaths.js';
+import {CONFIG_PATH, ensureConfigDir} from './configPaths.js';
 
 const create = React.createElement;
 const DEFAULT_CONFIG = {customCommands: {}};
@@ -17,7 +17,6 @@ const OUTPUT_WINDOW_HEIGHT = OUTPUT_WINDOW_SIZE + 2;
 const PROJECTS_MIN_WIDTH = 32;
 const DETAILS_MIN_WIDTH = 44;
 const HELP_CARD_MIN_WIDTH = 28;
-const RECENT_RUN_LIMIT = 5;
 const ACTION_MAP = {
   b: 'build',
   t: 'test',
@@ -172,10 +171,9 @@ function Compass({rootPath, initialView = 'navigator'}) {
   const [selectedIndex, setSelectedIndex] = useState(0);
   const [viewMode, setViewMode] = useState('list');
   const [mainView, setMainView] = useState(initialView);
-  const [logLines, setLogLines] = useState([]);
+  const [tasks, setTasks] = useState([]);
+  const [activeTaskId, setActiveTaskId] = useState(null);
   const [logOffset, setLogOffset] = useState(0);
-  const [running, setRunning] = useState(false);
-  const [lastAction, setLastAction] = useState(null);
   const [customMode, setCustomMode] = useState(false);
   const [customInput, setCustomInput] = useState('');
   const [customCursor, setCustomCursor] = useState(0);
@@ -185,18 +183,21 @@ function Compass({rootPath, initialView = 'navigator'}) {
   const [stdinBuffer, setStdinBuffer] = useState('');
   const [stdinCursor, setStdinCursor] = useState(0);
   const [showHelp, setShowHelp] = useState(false);
-  const [recentRuns, setRecentRuns] = useState([]);
   const selectedProject = projects[selectedIndex] || null;
-  const runningProcessRef = useRef(null);
+  const runningProcessMap = useRef(new Map());
   const lastCommandRef = useRef(null);
 
-  const addLog = useCallback((line) => {
-    setLogLines((prev) => {
+  const activeTask = useMemo(() => tasks.find(t => t.id === activeTaskId), [tasks, activeTaskId]);
+  const running = activeTask?.status === 'running';
+
+  const addLogToTask = useCallback((taskId, line) => {
+    setTasks(prev => prev.map(t => {
+      if (t.id !== taskId) return t;
       const normalized = typeof line === 'string' ? line : JSON.stringify(line);
       const lines = normalized.split(/\r?\n/).filter(l => l.trim().length > 0);
-      const appended = [...prev, ...lines];
-      return appended.length > 500 ? appended.slice(appended.length - 500) : appended;
-    });
+      const nextLogs = [...t.logs, ...lines];
+      return { ...t, logs: nextLogs.length > 500 ? nextLogs.slice(-500) : nextLogs };
+    }));
   }, []);
 
   const detailCommands = useMemo(() => buildDetailCommands(selectedProject, config), [selectedProject, config]);
@@ -212,85 +213,65 @@ function Compass({rootPath, initialView = 'navigator'}) {
 
   const runProjectCommand = useCallback(async (commandMeta, targetProject = selectedProject) => {
     const project = targetProject || selectedProject;
-    if (!project) {
-      return;
-    }
-    if (!commandMeta || !Array.isArray(commandMeta.command) || commandMeta.command.length === 0) {
-      addLog(kleur.gray('(no command configured)'));
-      return;
-    }
-    if (running) {
-      addLog(kleur.yellow('→ Wait for the current task to finish.'));
-      return;
-    }
+    if (!project) return;
+    if (!commandMeta || !Array.isArray(commandMeta.command) || commandMeta.command.length === 0) return;
 
     const commandLabel = commandMeta.label || commandMeta.command.join(' ');
+    const taskId = `task-${Date.now()}`;
+    const newTask = {
+      id: taskId,
+      name: `${project.name} · ${commandLabel}`,
+      status: 'running',
+      logs: [kleur.cyan(`> ${commandMeta.command.join(' ')}`)],
+      project: project.name
+    };
+
+    setTasks(prev => [...prev, newTask]);
+    setActiveTaskId(taskId);
     lastCommandRef.current = {project, commandMeta};
-    setRunning(true);
-    setLastAction(`${project.name} · ${commandLabel}`);
-    const fullCmd = commandMeta.command;
-    addLog(kleur.cyan(`> ${fullCmd.join(' ')}`));
-    setRecentRuns((prev) => {
-      const entry = {project: project.name, command: commandLabel, time: new Date().toLocaleTimeString()};
-      return [entry, ...prev].slice(0, RECENT_RUN_LIMIT);
-    });
 
     try {
-      const subprocess = execa(fullCmd[0], fullCmd.slice(1), {
+      const subprocess = execa(commandMeta.command[0], commandMeta.command.slice(1), {
         cwd: project.path,
         env: process.env,
         stdin: 'pipe'
       });
-      runningProcessRef.current = subprocess;
+      runningProcessMap.current.set(taskId, subprocess);
 
-      subprocess.stdout?.on('data', (chunk) => {
-        addLog(chunk.toString());
-      });
-      subprocess.stderr?.on('data', (chunk) => {
-        addLog(kleur.red(chunk.toString()));
-      });
+      subprocess.stdout?.on('data', (chunk) => addLogToTask(taskId, chunk.toString()));
+      subprocess.stderr?.on('data', (chunk) => addLogToTask(taskId, kleur.red(chunk.toString())));
 
       await subprocess;
-      addLog(kleur.green(`✓ ${commandLabel} finished`));
+      setTasks(prev => prev.map(t => t.id === taskId ? {...t, status: 'finished'} : t));
+      addLogToTask(taskId, kleur.green(`✓ ${commandLabel} finished`));
     } catch (error) {
-      addLog(kleur.red(`✗ ${commandLabel} failed: ${error.shortMessage || error.message}`));
+      setTasks(prev => prev.map(t => t.id === taskId ? {...t, status: 'failed'} : t));
+      addLogToTask(taskId, kleur.red(`✗ ${commandLabel} failed: ${error.shortMessage || error.message}`));
     } finally {
-      setRunning(false);
-      setStdinBuffer('');
-      setStdinCursor(0);
-      runningProcessRef.current = null;
+      runningProcessMap.current.delete(taskId);
     }
-  }, [addLog, running, selectedProject]);
+  }, [addLogToTask, selectedProject]);
 
   const handleAddCustomCommand = useCallback((label, commandTokens) => {
-    if (!selectedProject) {
-      return;
-    }
+    if (!selectedProject) return;
     setConfig((prev) => {
       const projectKey = selectedProject.path;
       const existing = prev.customCommands?.[projectKey] || [];
-      const nextCustom = [...existing, {label, command: commandTokens}];
       const nextConfig = {
         ...prev,
         customCommands: {
           ...prev.customCommands,
-          [projectKey]: nextCustom
+          [projectKey]: [...existing, {label, command: commandTokens}]
         }
       };
       saveConfig(nextConfig);
       return nextConfig;
     });
-    addLog(kleur.yellow(`Saved custom command "${label}" for ${selectedProject.name}`));
-  }, [selectedProject, addLog]);
+  }, [selectedProject]);
 
   const handleCustomSubmit = useCallback(() => {
     const raw = customInput.trim();
-    if (!selectedProject) {
-      setCustomMode(false);
-      return;
-    }
-    if (!raw) {
-      addLog(kleur.gray('Canceled custom command (empty).'));
+    if (!selectedProject || !raw) {
       setCustomMode(false);
       setCustomInput('');
       setCustomCursor(0);
@@ -299,44 +280,33 @@ function Compass({rootPath, initialView = 'navigator'}) {
     const [labelPart, commandPart] = raw.split('|');
     const commandTokens = (commandPart || labelPart).trim().split(/\s+/).filter(Boolean);
     if (!commandTokens.length) {
-      addLog(kleur.red('Custom command needs at least one token.'));
       setCustomMode(false);
       setCustomInput('');
       setCustomCursor(0);
       return;
     }
     const label = commandPart ? labelPart.trim() : `Custom ${selectedProject.name}`;
-    handleAddCustomCommand(label || 'Custom', commandTokens);
+    handleAddCustomCommand(label, commandTokens);
     setCustomMode(false);
     setCustomInput('');
     setCustomCursor(0);
-  }, [customInput, selectedProject, handleAddCustomCommand, addLog]);
+  }, [customInput, selectedProject, handleAddCustomCommand]);
 
   const exportLogs = useCallback(() => {
-    if (!logLines.length) {
-      return;
-    }
+    if (!activeTask || !activeTask.logs.length) return;
     try {
-      const exportPath = path.resolve(process.cwd(), `compass-logs-${Date.now()}.txt`);
-      fs.writeFileSync(exportPath, logLines.join('\n'));
-      addLog(kleur.green(`✓ Logs exported to ${exportPath}`));
+      const exportPath = path.resolve(process.cwd(), `compass-${activeTask.id}.txt`);
+      fs.writeFileSync(exportPath, activeTask.logs.join('\n'));
+      addLogToTask(activeTaskId, kleur.green(`✓ Logs exported to ${exportPath}`));
     } catch (err) {
-      addLog(kleur.red(`✗ Export failed: ${err.message}`));
+      addLogToTask(activeTaskId, kleur.red(`✗ Export failed: ${err.message}`));
     }
-  }, [logLines, addLog]);
+  }, [activeTask, activeTaskId, addLogToTask]);
 
     useInput((input, key) => {
     if (customMode) {
-      if (key.return) {
-        handleCustomSubmit();
-        return;
-      }
-      if (key.escape) {
-        setCustomMode(false);
-        setCustomInput('');
-        setCustomCursor(0);
-        return;
-      }
+      if (key.return) { handleCustomSubmit(); return; }
+      if (key.escape) { setCustomMode(false); setCustomInput(''); setCustomCursor(0); return; }
       if (key.backspace || key.delete) {
         if (customCursor > 0) {
           setCustomInput((prev) => prev.slice(0, customCursor - 1) + prev.slice(customCursor));
@@ -344,14 +314,8 @@ function Compass({rootPath, initialView = 'navigator'}) {
         }
         return;
       }
-      if (key.leftArrow) {
-        setCustomCursor(c => Math.max(0, c - 1));
-        return;
-      }
-      if (key.rightArrow) {
-        setCustomCursor(c => Math.min(customInput.length, c + 1));
-        return;
-      }
+      if (key.leftArrow) { setCustomCursor(c => Math.max(0, c - 1)); return; }
+      if (key.rightArrow) { setCustomCursor(c => Math.min(customInput.length, c + 1)); return; }
       if (input) {
         setCustomInput((prev) => prev.slice(0, customCursor) + input + prev.slice(customCursor));
         setCustomCursor(c => c + input.length);
@@ -360,51 +324,28 @@ function Compass({rootPath, initialView = 'navigator'}) {
     }
 
     const normalizedInput = input?.toLowerCase();
-    const ctrlCombo = (char) => key.ctrl && normalizedInput === char;
     const shiftCombo = (char) => key.shift && normalizedInput === char;
-    const toggleShortcut = (char) => shiftCombo(char);
-    if (toggleShortcut('h')) {
-      setShowHelpCards((prev) => !prev);
-      return;
-    }
-    if (toggleShortcut('s')) {
-      setShowStructureGuide((prev) => !prev);
-      return;
-    }
-    if (toggleShortcut('a')) {
-      setMainView((prev) => (prev === 'navigator' ? 'studio' : 'navigator'));
-      return;
-    }
-    if (toggleShortcut('x')) {
-      setLogLines([]);
-      setLogOffset(0);
-      return;
-    }
-    if (shiftCombo('e')) {
-      exportLogs();
-      return;
-    }
+    
+    if (shiftCombo('h')) { setShowHelpCards((prev) => !prev); return; }
+    if (shiftCombo('s')) { setShowStructureGuide((prev) => !prev); return; }
+    if (shiftCombo('a')) { setMainView((prev) => (prev === 'navigator' ? 'studio' : 'navigator')); return; }
+    if (shiftCombo('x')) { setTasks(prev => prev.map(t => t.id === activeTaskId ? {...t, logs: []} : t)); setLogOffset(0); return; }
+    if (shiftCombo('e')) { exportLogs(); return; }
+    if (shiftCombo('d')) { setActiveTaskId(null); return; }
+    if (shiftCombo('t')) { setMainView('tasks'); return; }
 
     const scrollLogs = (delta) => {
       setLogOffset((prev) => {
-        const maxScroll = Math.max(0, logLines.length - OUTPUT_WINDOW_SIZE);
+        const logs = activeTask?.logs || [];
+        const maxScroll = Math.max(0, logs.length - OUTPUT_WINDOW_SIZE);
         return Math.max(0, Math.min(maxScroll, prev + delta));
       });
     };
 
-    if (running && runningProcessRef.current) {
-      if (key.ctrl && input === 'c') {
-        runningProcessRef.current.kill('SIGINT');
-        setStdinBuffer('');
-        setStdinCursor(0);
-        return;
-      }
-      if (key.return) {
-        runningProcessRef.current.stdin?.write(stdinBuffer + '\n');
-        setStdinBuffer('');
-        setStdinCursor(0);
-        return;
-      }
+    if (running && activeTaskId && runningProcessMap.current.has(activeTaskId)) {
+      const proc = runningProcessMap.current.get(activeTaskId);
+      if (key.ctrl && input === 'c') { proc.kill('SIGINT'); setStdinBuffer(''); setStdinCursor(0); return; }
+      if (key.return) { proc.stdin?.write(stdinBuffer + '\n'); setStdinBuffer(''); setStdinCursor(0); return; }
       if (key.backspace || key.delete) {
         if (stdinCursor > 0) {
           setStdinBuffer(prev => prev.slice(0, stdinCursor - 1) + prev.slice(stdinCursor));
@@ -412,14 +353,8 @@ function Compass({rootPath, initialView = 'navigator'}) {
         }
         return;
       }
-      if (key.leftArrow) {
-        setStdinCursor(c => Math.max(0, c - 1));
-        return;
-      }
-      if (key.rightArrow) {
-        setStdinCursor(c => Math.min(stdinBuffer.length, c + 1));
-        return;
-      }
+      if (key.leftArrow) { setStdinCursor(c => Math.max(0, c - 1)); return; }
+      if (key.rightArrow) { setStdinCursor(c => Math.min(stdinBuffer.length, c + 1)); return; }
       if (input) {
         setStdinBuffer(prev => prev.slice(0, stdinCursor) + input + prev.slice(stdinCursor));
         setStdinCursor(c => c + input.length);
@@ -427,49 +362,29 @@ function Compass({rootPath, initialView = 'navigator'}) {
       return;
     }
 
-    if (key.shift && key.upArrow) {
-      scrollLogs(-1);
-      return;
-    }
-    if (key.shift && key.downArrow) {
-      scrollLogs(1);
-      return;
-    }
+    if (key.shift && key.upArrow) { scrollLogs(-1); return; }
+    if (key.shift && key.downArrow) { scrollLogs(1); return; }
 
-    if (normalizedInput === '?') {
-      setShowHelp((prev) => !prev);
-      return;
-    }
-    if (shiftCombo('l') && lastCommandRef.current) {
-      runProjectCommand(lastCommandRef.current.commandMeta, lastCommandRef.current.project);
-      return;
-    }
+    if (normalizedInput === '?') { setShowHelp((prev) => !prev); return; }
+    if (shiftCombo('l') && lastCommandRef.current) { runProjectCommand(lastCommandRef.current.commandMeta, lastCommandRef.current.project); return; }
 
-    if (key.upArrow && !key.shift && projects.length > 0) {
-      setSelectedIndex((prev) => (prev - 1 + projects.length) % projects.length);
-      return;
-    }
-    if (key.downArrow && !key.shift && projects.length > 0) {
-      setSelectedIndex((prev) => (prev + 1) % projects.length);
+    if (mainView === 'tasks') {
+      if (key.upArrow) { setActiveTaskId(prev => tasks[(tasks.findIndex(t => t.id === prev) - 1 + tasks.length) % tasks.length]?.id); return; }
+      if (key.downArrow) { setActiveTaskId(prev => tasks[(tasks.findIndex(t => t.id === prev) + 1) % tasks.length]?.id); return; }
+      if (key.return || shiftCombo('t')) { setMainView('navigator'); return; }
       return;
     }
+
+    if (key.upArrow && !key.shift && projects.length > 0) { setSelectedIndex((prev) => (prev - 1 + projects.length) % projects.length); return; }
+    if (key.downArrow && !key.shift && projects.length > 0) { setSelectedIndex((prev) => (prev + 1) % projects.length); return; }
     if (key.return) {
-      if (!selectedProject) {
-        return;
-      }
+      if (!selectedProject) return;
       setViewMode((prev) => (prev === 'detail' ? 'list' : 'detail'));
       return;
     }
-    if (shiftCombo('q')) {
-      exit();
-      return;
-    }
-    if (shiftCombo('c') && viewMode === 'detail' && selectedProject) {
-      setCustomMode(true);
-      setCustomInput('');
-      setCustomCursor(0);
-      return;
-    }
+    if (shiftCombo('q')) { exit(); return; }
+    if (shiftCombo('c') && viewMode === 'detail' && selectedProject) { setCustomMode(true); setCustomInput(''); setCustomCursor(0); return; }
+    
     const actionKey = normalizedInput && ACTION_MAP[normalizedInput];
     if (actionKey) {
       const commandMeta = selectedProject?.commands?.[actionKey];
@@ -482,17 +397,31 @@ function Compass({rootPath, initialView = 'navigator'}) {
   });
 
   const projectCountLabel = `${projects.length} project${projects.length === 1 ? '' : 's'}`;
-  const projectRows = [];
-  if (loading) {
-    projectRows.push(create(Text, {key: 'scanning', dimColor: true}, 'Scanning projects…'));
-  }
-  if (error) {
-    projectRows.push(create(Text, {key: 'error', color: 'red'}, `Unable to scan: ${error}`));
-  }
-  if (!loading && !error && projects.length === 0) {
-    projectRows.push(create(Text, {key: 'empty', dimColor: true}, 'No recognizable project manifests found.'));
+
+  if (mainView === 'studio') return create(Studio);
+
+  if (mainView === 'tasks') {
+    return create(
+      Box,
+      {flexDirection: 'column', borderStyle: 'round', borderColor: 'yellow', padding: 1},
+      create(Text, {bold: true, color: 'yellow'}, '🛰️ Task Manager | Background Processes'),
+      create(Text, {dimColor: true, marginBottom: 1}, 'Select a task to view its output logs.'),
+      ...tasks.map(t => create(
+        Box,
+        {key: t.id, marginBottom: 0},
+        create(Text, {color: t.id === activeTaskId ? 'cyan' : 'white', bold: t.id === activeTaskId}, `${t.id === activeTaskId ? '→' : ' '} [${t.status.toUpperCase()}] ${t.name}`)
+      )),
+      !tasks.length && create(Text, {dimColor: true}, 'No active or background tasks.'),
+      create(Text, {marginTop: 1, dimColor: true}, 'Press Enter/Shift+T to return to Navigator, Up/Down to switch focus.')
+    );
   }
-  if (!loading && mainView === 'navigator') {
+
+  const projectRows = [];
+  if (loading) projectRows.push(create(Text, {key: 'scanning', dimColor: true}, 'Scanning projects…'));
+  if (error) projectRows.push(create(Text, {key: 'error', color: 'red'}, `Unable to scan: ${error}`));
+  if (!loading && !error && projects.length === 0) projectRows.push(create(Text, {key: 'empty', dimColor: true}, 'No recognizable project manifests found.'));
+  
+  if (!loading) {
     projects.forEach((project, index) => {
       const isSelected = index === selectedIndex;
       const frameworkBadges = (project.frameworks || []).map((frame) => `${frame.icon} ${frame.name}`).join(', ');
@@ -504,14 +433,7 @@ function Compass({rootPath, initialView = 'navigator'}) {
           create(
             Box,
             {flexDirection: 'row'},
-            create(
-              Text,
-              {
-                color: isSelected ? 'cyan' : 'white',
-                bold: isSelected
-              },
-              `${project.icon} ${project.name}`
-            ),
+            create(Text, {color: isSelected ? 'cyan' : 'white', bold: isSelected}, `${project.icon} ${project.name}`),
             hasMissingRuntime && create(Text, {color: 'red', bold: true}, '  ⚠️ Runtime missing')
           ),
           create(Text, {dimColor: true}, `  ${project.type} · ${path.relative(rootPath, project.path) || '.'}`),
@@ -524,359 +446,88 @@ function Compass({rootPath, initialView = 'navigator'}) {
   const detailContent = [];
   if (viewMode === 'detail' && selectedProject) {
     detailContent.push(
-      create(
-        Box,
-        {key: 'title-row', flexDirection: 'row'},
+      create(Box, {key: 'title-row', flexDirection: 'row'}, 
         create(Text, {color: 'cyan', bold: true}, `${selectedProject.icon} ${selectedProject.name}`),
         selectedProject.missingBinaries && selectedProject.missingBinaries.length > 0 && create(Text, {color: 'red', bold: true}, '  ⚠️ MISSING RUNTIME')
       ),
       create(Text, {key: 'manifest', dimColor: true}, `${selectedProject.type} · ${selectedProject.manifest || 'detected manifest'}`),
       create(Text, {key: 'loc', dimColor: true}, `Location: ${path.relative(rootPath, selectedProject.path) || '.'}`)
     );
-    if (selectedProject.description) {
-      detailContent.push(create(Text, {key: 'desc'}, selectedProject.description));
-    }
+    if (selectedProject.description) detailContent.push(create(Text, {key: 'desc'}, selectedProject.description));
     const frameworks = (selectedProject.frameworks || []).map((lib) => `${lib.icon} ${lib.name}`).join(', ');
-    if (frameworks) {
-      detailContent.push(create(Text, {key: 'frames', dimColor: true}, `Frameworks: ${frameworks}`));
-    }
-    if (selectedProject.extra?.scripts && selectedProject.extra.scripts.length) {
-      detailContent.push(create(Text, {key: 'scripts', dimColor: true}, `Scripts: ${selectedProject.extra.scripts.join(', ')}`));
-    }
-
+    if (frameworks) detailContent.push(create(Text, {key: 'frames', dimColor: true}, `Frameworks: ${frameworks}`));
+    
     if (selectedProject.missingBinaries && selectedProject.missingBinaries.length > 0) {
       detailContent.push(
-        create(Text, {key: 'missing-title', color: 'red', bold: true, marginTop: 1}, 'MISSING BINARIES:'),
-        create(Text, {key: 'missing-list', color: 'red'}, `Please install: ${selectedProject.missingBinaries.join(', ')}`),
-        create(Text, {key: 'missing-hint', dimColor: true}, 'Project commands may fail until these are in your PATH.')
+        create(Text, {key: 'm-t', color: 'red', bold: true, marginTop: 1}, 'MISSING BINARIES:'),
+        create(Text, {key: 'm-l', color: 'red'}, `Please install: ${selectedProject.missingBinaries.join(', ')}`)
       );
     }
 
-    detailContent.push(create(Text, {key: 'config-path', dimColor: true, marginTop: 1}, `Custom commands stored in ${CONFIG_PATH}`));
-    detailContent.push(create(Text, {key: 'plugin-path', dimColor: true, marginBottom: 1}, `Extend frameworks via ${PLUGIN_FILE}`));
     detailContent.push(create(Text, {key: 'cmd-header', bold: true, marginTop: 1}, 'Commands'));
     detailedIndexed.forEach((command) => {
       detailContent.push(
-        create(Text, {key: `detail-${command.shortcut}-${command.label}`}, `${command.shortcut}. ${command.label} ${command.source === 'custom' ? kleur.magenta('(custom)') : command.source === 'framework' ? kleur.cyan('(framework)') : command.source === 'plugin' ? kleur.green('(plugin)') : ''}`)
+        create(Text, {key: `d-${command.shortcut}`}, `${command.shortcut}. ${command.label} ${command.source === 'custom' ? kleur.magenta('(custom)') : command.source === 'framework' ? kleur.cyan('(framework)') : ''}`),
+        create(Text, {key: `dl-${command.shortcut}`, dimColor: true}, `   ↳ ${command.command.join(' ')}`)
       );
-      detailContent.push(create(Text, {key: `detail-line-${command.shortcut}-${command.label}`, dimColor: true}, `   ↳ ${command.command.join(' ')}`));
     });
-    if (!detailedIndexed.length) {
-      detailContent.push(create(Text, {key: 'no-cmds', dimColor: true}, 'No built-in commands yet. Add a custom command with Shift+C.'));
-    }
-    const setupHints = selectedProject.extra?.setupHints || [];
-    if (setupHints.length) {
-      detailContent.push(create(Text, {key: 'setup-header', dimColor: true, marginTop: 1}, 'Setup hints:'));
-      setupHints.forEach((hint, hidx) => detailContent.push(create(Text, {key: `hint-${hidx}`, dimColor: true}, `  • ${hint}`)));
-    }
-    detailContent.push(create(Text, {key: 'hint-line', dimColor: true}, 'Press Shift+C → label|cmd to save custom actions, Enter to close detail view.'));
+    detailContent.push(create(Text, {key: 'h-l', dimColor: true, marginTop: 1}, 'Press Shift+C → label|cmd to save custom actions, Enter to close detail view.'));
   } else {
-    detailContent.push(create(Text, {key: 'enter-hint', dimColor: true}, 'Press Enter on a project to reveal details (icons, commands, frameworks, custom actions).'));
+    detailContent.push(create(Text, {key: 'e-h', dimColor: true}, 'Press Enter on a project to reveal details.'));
   }
 
   if (customMode) {
-    detailContent.push(
-      create(
-        Box,
-        {key: 'custom-input-box', flexDirection: 'row'},
-        create(Text, {color: 'cyan'}, 'Type label|cmd (Enter: save, Esc: cancel): '),
-        create(CursorText, {value: customInput, cursorIndex: customCursor})
-      )
-    );
+    detailContent.push(create(Box, {key: 'ci-box', flexDirection: 'row'}, create(Text, {color: 'cyan'}, 'Type label|cmd (Enter: save, Esc: cancel): '), create(CursorText, {value: customInput, cursorIndex: customCursor})));
   }
 
-  const artTileNodes = useMemo(() => {
-    const selectedName = selectedProject?.name || 'Awaiting selection';
-    const selectedType = selectedProject?.type || 'Unknown stack';
-    const selectedLocation = selectedProject?.path ? path.relative(rootPath, selectedProject.path) || '.' : '—';
-    const statusNarrative = running ? 'Running commands' : lastAction ? `Last: ${lastAction}` : 'Idle gallery';
-    const workspaceName = path.basename(rootPath) || rootPath;
-    const tileDefinition = [
-      {
-        label: 'Pulse',
-        detail: projectCountLabel,
-        accent: 'magenta',
-        icon: '●',
-        subtext: `Workspace · ${workspaceName}`
-      },
-      {
-        label: 'Focus',
-        detail: selectedName,
-        accent: 'cyan',
-        icon: '◆',
-        subtext: `${selectedType} · ${selectedLocation}`
-      },
-      {
-        label: 'Rhythm',
-        detail: `${detailCommands.length} commands`,
-        accent: 'yellow',
-        icon: '■',
-        subtext: statusNarrative
-      }
-    ];
-    return tileDefinition.map((tile) =>
-      create(
-        Box,
-        {
-          key: tile.label,
-          flexDirection: 'column',
-          padding: 1,
-          marginRight: 1,
-          borderStyle: 'single',
-          borderColor: tile.accent,
-          minWidth: 24
-        },
-        create(Text, {color: tile.accent, bold: true}, `${tile.icon} ${tile.label}`),
-        create(Text, {bold: true}, tile.detail),
-        create(Text, {dimColor: true}, tile.subtext)
-      )
-    );
-  }, [projectCountLabel, rootPath, selectedProject, detailCommands.length, running, lastAction]);
-
-  const artBoard = create(
-    Box,
-    {
-      flexDirection: 'column',
-      marginTop: 1,
-      borderStyle: 'round',
-      borderColor: 'gray',
-      padding: 1
-    },
-    create(
-      Box,
-      {flexDirection: 'row', justifyContent: 'space-between'},
-      create(Text, {color: 'magenta', bold: true}, 'Art-coded build atlas'),
-      create(Text, {dimColor: true}, 'press ? for overlay help')
-    ),
-    create(
-      Box,
-      {flexDirection: 'row', marginTop: 1},
-      ...ART_CHARS.map((char, index) =>
-        create(Text, {key: `art-${index}`, color: ART_COLORS[index % ART_COLORS.length]}, char.repeat(2))
-      )
-    ),
-    create(
-      Box,
-      {flexDirection: 'row', marginTop: 1},
-      ...artTileNodes
-    ),
-    create(Text, {dimColor: true, marginTop: 1}, kleur.italic('The art board now follows your layout and stays inside the window.'))
+  const artTileNodes = [
+    {label: 'Pulse', detail: projectCountLabel, accent: 'magenta', icon: '●', subtext: `Workspace · ${path.basename(rootPath) || rootPath}`},
+    {label: 'Focus', detail: selectedProject?.name || 'Selection', accent: 'cyan', icon: '◆', subtext: `${selectedProject?.type || 'Stack'}`},
+    {label: 'Orbit', detail: `${tasks.length} active tasks`, accent: 'yellow', icon: '■', subtext: running ? 'Busy streaming...' : 'Idle'}
+  ].map(tile => create(Box, {key: tile.label, flexDirection: 'column', padding: 1, marginRight: 1, borderStyle: 'single', borderColor: tile.accent, minWidth: 24},
+    create(Text, {color: tile.accent, bold: true}, `${tile.icon} ${tile.label}`),
+    create(Text, {bold: true}, tile.detail),
+    create(Text, {dimColor: true}, tile.subtext)
+  ));
+
+  const artBoard = create(Box, {flexDirection: 'column', marginTop: 1, borderStyle: 'round', borderColor: 'gray', padding: 1},
+    create(Box, {flexDirection: 'row', justifyContent: 'space-between'}, create(Text, {color: 'magenta', bold: true}, 'Art-coded build atlas'), create(Text, {dimColor: true}, 'press ? for overlay help')),
+    create(Box, {flexDirection: 'row', marginTop: 1}, ...ART_CHARS.map((char, i) => create(Text, {key: i, color: ART_COLORS[i % ART_COLORS.length]}, char.repeat(2)))),
+    create(Box, {flexDirection: 'row', marginTop: 1}, ...artTileNodes)
   );
 
-  const logWindowStart = Math.max(0, logLines.length - OUTPUT_WINDOW_SIZE - logOffset);
-  const logWindowEnd = Math.max(0, logLines.length - logOffset);
-  const visibleLogs = logLines.slice(logWindowStart, logWindowEnd);
-  const logNodes = visibleLogs.length
-    ? visibleLogs.map((line, index) => create(Text, {key: index}, line))
-    : [create(Text, {key: 'no-logs', dimColor: true}, 'Logs will appear here once you run a command.')];
+  const logs = activeTask?.logs || [];
+  const logWindowStart = Math.max(0, logs.length - OUTPUT_WINDOW_SIZE - logOffset);
+  const logWindowEnd = Math.max(0, logs.length - logOffset);
+  const visibleLogs = logs.slice(logWindowStart, logWindowEnd);
+  const logNodes = visibleLogs.length ? visibleLogs.map((line, i) => create(Text, {key: i}, line)) : [create(Text, {dimColor: true}, 'Select a task or run a command to see logs.')];
 
   const helpCards = [
-    {
-      label: 'Navigation',
-      color: 'magenta',
-      body: [
-        '↑ / ↓ move focus, Enter: details',
-        'Shift+↑ / ↓ scroll output',
-        'Shift+H toggle help cards',
-        '? opens the overlay help'
-      ]
-    },
-    {
-      label: 'Command flow',
-      color: 'cyan',
-      body: [
-        'B / T / R build/test/run',
-        '1-9 run detail commands',
-        'Shift+L rerun last command',
-        'Shift+X clear / Shift+E export'
-      ]
-    },
-    {
-      label: 'System & Studio',
-      color: 'yellow',
-      body: [
-        'Shift+A open Omni-Studio',
-        'Shift+S toggle structure guide',
-        'Shift+C save custom action',
-        'Shift+Q quit application'
-      ]
-    }
+    {label: 'Navigation', color: 'magenta', body: ['↑ / ↓ move focus, Enter: details', 'Shift+↑ / ↓ scroll output', 'Shift+H toggle help cards', 'Shift+D detach from task']},
+    {label: 'Commands', color: 'cyan', body: ['B / T / R build/test/run', '1-9 run detail commands', 'Shift+L rerun last command', 'Shift+X clear / Shift+E export']},
+    {label: 'Orbit & Studio', color: 'yellow', body: ['Shift+T task manager', 'Shift+A open Omni-Studio', 'Shift+C save custom action', 'Shift+Q quit application']}
   ];
-  const helpSection = showHelpCards
-    ? create(
-        Box,
-        {marginTop: 1, flexDirection: 'row', justifyContent: 'space-between', flexWrap: 'wrap'},
-        ...helpCards.map((card, index) =>
-          create(
-            Box,
-            {
-              key: card.label,
-              flexGrow: 1,
-              flexBasis: 0,
-              minWidth: HELP_CARD_MIN_WIDTH,
-              marginRight: index < helpCards.length - 1 ? 1 : 0,
-              marginBottom: 1,
-              borderStyle: 'round',
-              borderColor: card.color,
-              padding: 1,
-              flexDirection: 'column'
-            },
-            create(Text, {color: card.color, bold: true, marginBottom: 1}, card.label),
-            ...card.body.map((line, lineIndex) =>
-              create(Text, {key: `${card.label}-${lineIndex}`, dimColor: card.color === 'yellow'}, line)
-            )
-          )
-        )
-      )
-    : create(Text, {key: 'help-hint', dimColor: true, marginTop: 1}, 'Help cards hidden · press Shift+H to show navigation, command flow, and recent runs.');
-
-  const structureGuide = showStructureGuide
-    ? create(
-        Box,
-        {
-          flexDirection: 'column',
-          borderStyle: 'round',
-          borderColor: 'blue',
-          marginTop: 1,
-          padding: 1
-        },
-        create(Text, {color: 'cyan', bold: true}, 'Project structure guide · press Shift+S to hide'),
-        ...SCHEMA_GUIDE.map((entry) =>
-          create(Text, {key: entry.type, dimColor: true}, `• ${entry.icon} ${entry.label}: ${entry.files.join(', ')}`)
-        ),
-        create(Text, {dimColor: true, marginTop: 1}, 'SCHEMAS describe the manifests that trigger each language type.')
-      )
-    : null;
-
-  const helpOverlay = showHelp
-    ? create(
-        Box,
-        {
-          flexDirection: 'column',
-          borderStyle: 'double',
-          borderColor: 'cyan',
-          marginTop: 1,
-          padding: 1
-        },
-        create(Text, {color: 'cyan', bold: true}, 'Help overlay · press ? to hide'),
-        create(Text, null, 'Shift+↑/↓ scrolls logs; Shift+X clears; Shift+E exports to file; Shift+A Omni-Studio.'),
-        create(Text, null, 'B/T/R run build/test/run; 1-9 detail commands; Shift+L reruns previous command.'),
-        create(Text, null, 'Shift+H help cards, Shift+S structure guide, ? overlay, Shift+Q quits.'),
-        create(Text, null, 'Projects + Details stay paired while Output keeps its own full-width band.'),
-        create(Text, null, 'Structure guide lists the manifests that trigger each language detection.')
-      )
-    : null;
-
-  if (mainView === 'studio') {
-    return create(Studio);
-  }
 
-  const toggleHint = showHelpCards ? 'Shift+H hides the help cards' : 'Shift+H shows the help cards';
-  const headerHint = viewMode === 'detail'
-    ? `Detail mode · 1-${Math.max(detailedIndexed.length, 1)} to execute, Shift+C: add custom commands, Enter: back to list, Shift+Q: quit · ${toggleHint}, Shift+S toggles structure guide`
-    : `Quick run · B/T/R to build/test/run, Enter: view details, Shift+Q: quit · ${toggleHint}, Shift+S toggles structure guide`;
-
-  return create(
-    Box,
-    {flexDirection: 'column', padding: 1},
-    create(
-      Box,
-      {justifyContent: 'space-between'},
-      create(
-        Box,
-        {flexDirection: 'column'},
-        create(Text, {color: 'magenta', bold: true}, 'Project Compass'),
-        create(Text, {dimColor: true}, loading ? 'Scanning workspaces…' : `${projectCountLabel} detected in ${rootPath}`),
-        create(Text, {dimColor: true}, 'Use keyboard arrows to navigate, ? for help.')
-      ),
-      create(
-        Box,
-        {flexDirection: 'column', alignItems: 'flex-end'},
-        create(Text, {color: running ? 'yellow' : 'green'}, running ? 'Busy streaming...' : lastAction ? `Last action · ${lastAction}` : 'Idle'),
-        create(Text, {dimColor: true}, headerHint)
-      )
+  const toggleHint = showHelpCards ? 'Shift+H hide help' : 'Shift+H show help';
+  return create(Box, {flexDirection: 'column', padding: 1},
+    create(Box, {justifyContent: 'space-between'},
+      create(Box, {flexDirection: 'column'}, create(Text, {color: 'magenta', bold: true}, 'Project Compass'), create(Text, {dimColor: true}, `${projectCountLabel} detected in ${rootPath}`)),
+      create(Box, {flexDirection: 'column', alignItems: 'flex-end'}, create(Text, {color: running ? 'yellow' : 'green'}, activeTask ? `[${activeTask.status.toUpperCase()}] ${activeTask.name}` : 'Idle Navigator'), create(Text, {dimColor: true}, `${toggleHint}, Shift+T: Tasks, Shift+Q: Quit`))
     ),
     artBoard,
-    create(
-      Box,
-      {marginTop: 1, flexDirection: 'row', alignItems: 'stretch', width: '100%', flexWrap: 'wrap'},
-      create(
-        Box,
-        {
-          flexGrow: 1,
-          flexBasis: 0,
-          flexShrink: 1,
-          minWidth: PROJECTS_MIN_WIDTH,
-          marginRight: 1,
-          borderStyle: 'round',
-          borderColor: 'magenta',
-          padding: 1
-        },
-        create(Text, {bold: true, color: 'magenta'}, 'Projects'),
-        create(Box, {flexDirection: 'column', marginTop: 1}, ...projectRows)
-      ),
-      create(
-        Box,
-        {
-          flexGrow: 1.3,
-          flexBasis: 0,
-          flexShrink: 1,
-          minWidth: DETAILS_MIN_WIDTH,
-          borderStyle: 'round',
-          borderColor: 'cyan',
-          padding: 1,
-          flexDirection: 'column'
-        },
-        create(Text, {bold: true, color: 'cyan'}, 'Details'),
-        ...detailContent
-      )
+    create(Box, {marginTop: 1, flexDirection: 'row', alignItems: 'stretch', width: '100%', flexWrap: 'wrap'},
+      create(Box, {flexGrow: 1, flexBasis: 0, minWidth: PROJECTS_MIN_WIDTH, marginRight: 1, borderStyle: 'round', borderColor: 'magenta', padding: 1}, create(Text, {bold: true, color: 'magenta'}, 'Projects'), create(Box, {flexDirection: 'column', marginTop: 1}, ...projectRows)),
+      create(Box, {flexGrow: 1.3, flexBasis: 0, minWidth: DETAILS_MIN_WIDTH, borderStyle: 'round', borderColor: 'cyan', padding: 1, flexDirection: 'column'}, create(Text, {bold: true, color: 'cyan'}, 'Details'), ...detailContent)
     ),
-    create(
-      Box,
-      {marginTop: 1, flexDirection: 'column'},
-      create(
-        Box,
-        {flexDirection: 'row', justifyContent: 'space-between'},
-        create(Text, {bold: true, color: 'yellow'}, `Output ${running ? '· Running' : ''}`),
-        create(Text, {dimColor: true}, logOffset ? `Scrolled ${logOffset} lines` : 'Live log view')
-      ),
-      create(
-        Box,
-        {
-          flexDirection: 'column',
-          borderStyle: 'round',
-          borderColor: 'yellow',
-          padding: 1,
-          minHeight: OUTPUT_WINDOW_HEIGHT,
-          maxHeight: OUTPUT_WINDOW_HEIGHT,
-          height: OUTPUT_WINDOW_HEIGHT,
-          overflow: 'hidden',
-          flexShrink: 0
-        },
-        ...logNodes
-      ),
-      create(
-        Box,
-        {marginTop: 1, flexDirection: 'row', justifyContent: 'space-between'},
-        create(Text, {dimColor: true}, running ? 'Type to feed stdin; Enter submits, Ctrl+C aborts.' : 'Run a command or press ? for extra help.'),
-        create(Text, {dimColor: true}, `${toggleHint}, Shift+S toggles the structure guide`)
-      ),
-      create(
-        Box,
-        {
-          marginTop: 1,
-          flexDirection: 'row',
-          borderStyle: 'round',
-          borderColor: running ? 'green' : 'gray',
-          paddingX: 1
-        },
-        create(Text, {bold: true, color: running ? 'green' : 'white'}, running ? ' Stdin buffer ' : ' Input ready '),
-        create(Box, {marginLeft: 1}, create(CursorText, {value: stdinBuffer || (running ? '' : 'Start a command to feed stdin'), cursorIndex: stdinCursor, active: running}))
-      )
+    create(Box, {marginTop: 1, flexDirection: 'column'},
+      create(Box, {flexDirection: 'row', justifyContent: 'space-between'}, create(Text, {bold: true, color: 'yellow'}, `Output: ${activeTask?.name || 'None'}`), create(Text, {dimColor: true}, logOffset ? `Scrolled ${logOffset} lines` : 'Live log view')),
+      create(Box, {flexDirection: 'column', borderStyle: 'round', borderColor: 'yellow', padding: 1, minHeight: OUTPUT_WINDOW_HEIGHT, maxHeight: OUTPUT_WINDOW_HEIGHT, height: OUTPUT_WINDOW_HEIGHT, overflow: 'hidden'}, ...logNodes),
+      create(Box, {marginTop: 1, flexDirection: 'row', justifyContent: 'space-between'}, create(Text, {dimColor: true}, running ? 'Type to feed stdin; Enter: submit, Ctrl+C: abort.' : 'Run a command or press Shift+T to switch tasks.'), create(Text, {dimColor: true}, `${toggleHint}, Shift+S: Structure Guide`)),
+      create(Box, {marginTop: 1, flexDirection: 'row', borderStyle: 'round', borderColor: running ? 'green' : 'gray', paddingX: 1}, create(Text, {bold: true, color: running ? 'green' : 'white'}, running ? ' Stdin buffer ' : ' Input ready '), create(Box, {marginLeft: 1}, create(CursorText, {value: stdinBuffer || (running ? '' : 'Start a command to feed stdin'), cursorIndex: stdinCursor, active: running})))
     ),
-    helpSection,
-    structureGuide,
-    helpOverlay
+    showHelpCards && create(Box, {marginTop: 1, flexDirection: 'row', justifyContent: 'space-between', flexWrap: 'wrap'}, ...helpCards.map((card, idx) => create(Box, {key: card.label, flexGrow: 1, flexBasis: 0, minWidth: HELP_CARD_MIN_WIDTH, marginRight: idx < 2 ? 1 : 0, marginBottom: 1, borderStyle: 'round', borderColor: card.color, padding: 1, flexDirection: 'column'}, create(Text, {color: card.color, bold: true, marginBottom: 1}, card.label), ...card.body.map((line, lidx) => create(Text, {key: lidx, dimColor: card.color === 'yellow'}, line))))),
+    showStructureGuide && create(Box, {flexDirection: 'column', borderStyle: 'round', borderColor: 'blue', marginTop: 1, padding: 1}, create(Text, {color: 'cyan', bold: true}, 'Structure guide · press Shift+S to hide'), ...SCHEMA_GUIDE.map(e => create(Text, {key: e.type, dimColor: true}, `• ${e.icon} ${e.label}: ${e.files.join(', ')}`))),
+    showHelp && create(Box, {flexDirection: 'column', borderStyle: 'double', borderColor: 'cyan', marginTop: 1, padding: 1}, create(Text, {color: 'cyan', bold: true}, 'Help overlay'), create(Text, null, 'Shift+↑/↓ scrolls logs; Shift+X clears; Shift+E exports; Shift+A Studio; Shift+T Tasks; Shift+D Detach.'))
   );
 }
 
@@ -886,17 +537,10 @@ function parseArgs() {
   const tokens = process.argv.slice(2);
   for (let i = 0; i < tokens.length; i += 1) {
     const token = tokens[i];
-    if ((token === '--dir' || token === '--path') && tokens[i + 1]) {
-      args.root = tokens[i + 1];
-      i += 1;
-    } else if (token === '--mode' && tokens[i + 1]) {
-      args.mode = tokens[i + 1];
-      i += 1;
-    } else if (token === '--help' || token === '-h') {
-      args.help = true;
-    } else if (token === '--studio') {
-      args.view = 'studio';
-    }
+    if ((token === '--dir' || token === '--path') && tokens[i + 1]) { args.root = tokens[i + 1]; i += 1; }
+    else if (token === '--mode' && tokens[i + 1]) { args.mode = tokens[i + 1]; i += 1; }
+    else if (token === '--help' || token === '-h') args.help = true;
+    else if (token === '--studio') args.view = 'studio';
   }
   return args;
 }
@@ -918,9 +562,11 @@ async function main() {
     console.log('  ↑ / ↓                 Move project focus');
     console.log('  Enter                 Toggle detail view for selected project');
     console.log('  Shift+A               Switch to Omni-Studio (Environment Health)');
-    console.log('  Shift+X               Clear the output log buffer');
+    console.log('  Shift+T               Open Orbit Task Manager (Manage background processes)');
+    console.log('  Shift+D               Detach from active task (Keep it running in background)');
+    console.log('  Shift+X               Clear active task output log');
     console.log('  Shift+E               Export current logs to a .txt file');
-    console.log('  Shift+↑ / ↓           Scroll the output logs back/forward');
+    console.log('  Shift+↑ / ↓           Scroll the output logs');
     console.log('  Shift+Q               Quit application');
     console.log('');
     console.log(kleur.bold('Execution shortcuts:'));
@@ -936,16 +582,11 @@ async function main() {
   if (args.mode === 'test') {
     const projects = await discoverProjects(rootPath);
     console.log(`Detected ${projects.length} project(s) under ${rootPath}`);
-    projects.forEach((project) => {
-      console.log(` • [${project.type}] ${project.name} (${project.path})`);
-    });
+    projects.forEach((project) => { console.log(` • [${project.type}] ${project.name} (${project.path})`); });
     return;
   }
 
   render(create(Compass, {rootPath, initialView: args.view || 'navigator'}));
 }
 
-main().catch((error) => {
-  console.error(error);
-  process.exit(1);
-});
+main().catch((error) => { console.error(error); process.exit(1); });