project-compass 2.9.1 → 3.0.0

package/README.md

@@ -1,4 +1,4 @@
-# Project Compass (v2.8.0)
+# Project Compass (v2.9.2)
 
 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.
 
@@ -14,6 +14,7 @@ Project Compass is a futuristic CLI navigator built with [Ink](https://github.co
 - 💎 **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**.
 - 🔌 **Extensible**: Add custom commands with **Shift+C** and frameworks via `plugins.json`.
+- 💾 **Persistence**: Saves your UI preferences (Art Board, Help, Structure Guide) globally in `~/.project-compass/config.json`.
 
 ## Installation
 
@@ -37,20 +38,26 @@ project-compass [--dir /path/to/workspace] [--studio]
 | **Shift+T** | Open **Orbit Task Manager** |
 | **Shift+D** | **Detach** from active task (runs in background) |
 | **Shift+A** | Open **Omni-Studio** (Environment View) |
+| **Shift+B** | Toggle **Art Board** visibility |
+| **Shift+H** | Toggle **Help Cards** visibility |
+| **Shift+S** | Toggle **Structure Guide** visibility |
 | **Shift+C** | Add a custom command (`label|cmd`) |
 | **Shift+X** | **Clear output logs** |
 | **Shift+E** | **Export logs to .txt** |
 | **Shift ↑ / ↓** | Scroll output buffer |
 | **Shift+L** | Rerun last command |
-| **Shift+H** | Toggle help cards |
-| **Shift+S** | Toggle structure guide |
-| **Shift+Q** | Quit app |
+| **Shift+Q** | Quit app (with confirmation if tasks run) |
 | ? | Toggle help overlay |
 | Ctrl+C | Interrupt running command |
 
 ## Orbit Task Manager
 
-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 introduces background task management. You can start a build, press **Shift+D** to detach and return to the navigator, then start another task. 
+
+Inside the Task Manager (**Shift+T**):
+- **Shift+K**: Kill a running process or remove a task from history.
+- **Shift+R**: Rename a task for better organization.
+- **Enter**: Switch back to the Navigator with the selected task's logs.
 
 ## Omni-Studio
 

package/commands.md

@@ -0,0 +1,72 @@
+# Project Compass · Commands & Shortcuts
+
+This document lists all supported languages, frameworks, and their built-in commands and keyboard shortcuts.
+
+## Keyboard Guide (Navigator)
+
+| Key | Action |
+| --- | --- |
+| ↑ / ↓ | Move project focus |
+| Enter | Toggle detail view for selected project / Switch back from Tasks |
+| **Shift+A** | Open **Omni-Studio** (Environment intelligence) |
+| **Shift+T** | Open **Orbit Task Manager** |
+| **Shift+D** | **Detach** from active task (runs in background) |
+| **Shift+B** | Toggle **Art Board** visibility (Saved to config) |
+| **Shift+H** | Toggle **Help Cards** visibility (Saved to config) |
+| **Shift+S** | Toggle **Structure Guide** visibility (Saved to config) |
+| **Shift+X** | **Clear** active task output logs |
+| **Shift+E** | **Export** logs to a timestamped `.txt` file |
+| **Shift+L** | **Rerun** the last executed command |
+| **Shift+C** | Add a **Custom Command** (`label|cmd`) in detail view |
+| **Shift+Q** | **Quit** application (Confirms if tasks are running) |
+| Shift+↑ / ↓ | Scroll output logs (Intuitive direction) |
+| ? | Toggle help overlay |
+| Ctrl+C | Interrupt running command |
+
+## Supported Languages & Runtimes
+
+Compass scans for the following manifests and requires their binaries in your PATH:
+
+- **Node.js** (`node`, `npm`): `package.json`
+- **Python** (`python3`, `pip`): `pyproject.toml`, `requirements.txt`, `Pipfile`, `setup.py`
+- **Rust** (`cargo`): `Cargo.toml`
+- **Go** (`go`): `go.mod`
+- **Java/Kotlin** (`java`, `mvn`, `gradle`): `pom.xml`, `build.gradle`
+- **Scala** (`sbt`): `build.sbt`
+- **PHP** (`php`, `composer`): `composer.json`
+- **Ruby** (`ruby`, `bundle`): `Gemfile`
+- **.NET** (`dotnet`): `*.csproj`
+- **Shell** (`sh`, `make`): `Makefile`, `build.sh`
+
+## Built-in Framework Intelligence
+
+When a framework is detected, specialized commands are injected automatically:
+
+| Framework | Icon | Commands |
+| --- | --- | --- |
+| **Next.js** | 🧭 | install, dev, build, test, start |
+| **React** | ⚛️ | install, dev, build, test |
+| **Vue.js** | 🟩 | install, dev, build, test |
+| **NestJS** | 🛡️ | install, dev (start:dev), build, test |
+| **Angular** | 🅰️ | install, serve, build, test |
+| **SvelteKit** | 🌀 | install, dev, build, test, preview |
+| **Nuxt** | 🪄 | install, dev, build, start |
+| **Astro** | ✨ | install, dev, build, preview |
+| **Django** | 🌿 | pip install, runserver, test, migrate |
+| **Flask** | 🍶 | pip install, run, pytest |
+| **FastAPI** | ⚡ | pip install, uvicorn reload, pytest |
+| **Vite** | ⚡ | install, dev, build, preview |
+| **Spring Boot** | 🌱 | bootRun (Gradle) / spring-boot:run (Maven), build, test |
+| **ASP.NET Core**| 🌐 | restore, run, watch, test |
+| **Laravel** | 🧡 | composer install, artisan serve, test, migrate |
+| **Rocket** | 🚀 | cargo fetch, run, test |
+| **Actix Web** | 🦀 | cargo fetch, run, test |
+| **Prisma** | ◮ | install, generate, studio |
+| **Tailwind** | 🎨 | install |
+
+## Task Manager Shortcuts (Shift+T)
+
+- **Shift+K**: Kill a running process or remove a finished task from history.
+- **Shift+R**: Rename a task for better organization.
+- **Arrows**: Move focus between tasks.
+- **Enter**: Jump to the selected task's logs in Navigator.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-compass",
-  "version": "2.9.1",
+  "version": "3.0.0",
   "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

@@ -39,13 +39,15 @@ function loadConfig() {
       return {
         customCommands: {},
         showArtBoard: true,
+        showHelpCards: false,
+        showStructureGuide: false,
         ...parsed,
       };
     }
   } catch (error) {
     console.error(`Ignoring corrupt config: ${error.message}`);
   }
-  return {customCommands: {}, showArtBoard: true};
+  return {customCommands: {}, showArtBoard: true, showHelpCards: false, showStructureGuide: false};
 }
 
 function useScanner(rootPath) {
@@ -176,8 +178,6 @@ function Compass({rootPath, initialView = 'navigator'}) {
   const [renameCursor, setRenameCursor] = useState(0);
   const [quitConfirm, setQuitConfirm] = useState(false);
   const [config, setConfig] = useState(() => loadConfig());
-  const [showHelpCards, setShowHelpCards] = useState(false);
-  const [showStructureGuide, setShowStructureGuide] = useState(false);
   const [stdinBuffer, setStdinBuffer] = useState('');
   const [stdinCursor, setStdinCursor] = useState(0);
   const [showHelp, setShowHelp] = useState(false);
@@ -354,8 +354,22 @@ function Compass({rootPath, initialView = 'navigator'}) {
     const normalizedInput = input?.toLowerCase();
     const shiftCombo = (char) => key.shift && normalizedInput === char;
     
-    if (shiftCombo('h')) { setShowHelpCards((prev) => !prev); return; }
-    if (shiftCombo('s')) { setShowStructureGuide((prev) => !prev); return; }
+    if (shiftCombo('h')) { 
+      setConfig(prev => {
+        const next = {...prev, showHelpCards: !prev.showHelpCards};
+        saveConfig(next);
+        return next;
+      });
+      return; 
+    }
+    if (shiftCombo('s')) { 
+      setConfig(prev => {
+        const next = {...prev, showStructureGuide: !prev.showStructureGuide};
+        saveConfig(next);
+        return next;
+      });
+      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; }
@@ -451,6 +465,10 @@ function Compass({rootPath, initialView = 'navigator'}) {
   });
 
   const projectCountLabel = `${projects.length} project${projects.length === 1 ? '' : 's'}`;
+  const toggleHint = config.showHelpCards ? 'Shift+H hide help' : 'Shift+H show help';
+  const statusHint = activeTask ? `[${activeTask.status.toUpperCase()}] ${activeTask.name}` : 'Idle Navigator';
+  const orbitHint = mainView === 'tasks' ? 'Tasks View' : `Orbit: ${tasks.length} tasks`;
+  const artHint = config.showArtBoard ? 'Shift+B hide art' : 'Shift+B show art';
 
   if (quitConfirm) {
     return create(Box, {flexDirection: 'column', borderStyle: 'round', borderColor: 'red', padding: 1}, create(Text, {bold: true, color: 'red'}, '⚠️ Confirm Exit'), create(Text, null, `There are ${tasks.filter(t=>t.status==='running').length} tasks still running in the background.`), create(Text, null, 'Are you sure you want to quit and stop all processes?'), create(Text, {marginTop: 1}, kleur.bold('Y') + ' to Quit, ' + kleur.bold('N') + ' to Cancel'));
@@ -561,14 +579,16 @@ function Compass({rootPath, initialView = 'navigator'}) {
   const helpCards = [
     {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 studio / Shift+B art', 'Shift+C custom / Shift+Q quit']}
+    {label: 'Orbit & Studio', color: 'yellow', body: ['Shift+T task manager', 'Shift+A studio / Shift+B art board', 'Shift+S structure / Shift+Q quit']}
   ];
 
-  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`))
+      create(Box, {flexDirection: 'column', alignItems: 'flex-end'}, 
+        create(Text, {color: running ? 'yellow' : 'green'}, statusHint), 
+        create(Text, {dimColor: true}, `${toggleHint} · ${orbitHint} · ${artHint} · Shift+Q: Quit`)
+      )
     ),
     artBoard,
     create(Box, {marginTop: 1, flexDirection: 'row', alignItems: 'stretch', width: '100%', flexWrap: 'wrap'},
@@ -581,9 +601,9 @@ function Compass({rootPath, initialView = 'navigator'}) {
       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})))
     ),
-    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; Shift+B Toggle Art.'))
+    config.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))))),
+    config.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; Shift+B Toggle Art Board.'))
   );
 }
 
@@ -621,6 +641,8 @@ async function main() {
     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+B               Toggle Art Board visibility');
+    console.log('  Shift+H               Toggle Help Cards visibility');
+    console.log('  Shift+S               Toggle Structure Guide visibility');
     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');

package/src/projectDetection.js

@@ -123,13 +123,11 @@ const builtInFrameworks = [
           commands[key] = {label, command: tokens, source: 'framework'};
         }
       };
-      const buildFallback = () => ['npx', 'next', 'build'];
-      const startFallback = () => ['npx', 'next', 'start'];
-      const devFallback = () => ['npx', 'next', 'dev'];
-      add('run', 'Next dev', devFallback);
-      add('build', 'Next build', buildFallback);
+      add('install', 'Next install', () => ['npm', 'install']);
+      add('run', 'Next dev', () => ['npx', 'next', 'dev']);
+      add('build', 'Next build', () => ['npx', 'next', 'build']);
       add('test', 'Next test', () => ['npm', 'run', 'test']);
-      add('start', 'Next start', startFallback);
+      add('start', 'Next start', () => ['npx', 'next', 'start']);
       return commands;
     }
   },
@@ -151,6 +149,7 @@ const builtInFrameworks = [
           commands[key] = {label, command: tokens, source: 'framework'};
         }
       };
+      add('install', 'React install', () => ['npm', 'install']);
       add('run', 'React dev', () => ['npm', 'run', 'dev']);
       add('build', 'React build', () => ['npm', 'run', 'build']);
       add('test', 'React test', () => ['npm', 'run', 'test']);
@@ -175,6 +174,7 @@ const builtInFrameworks = [
           commands[key] = {label, command: tokens, source: 'framework'};
         }
       };
+      add('install', 'Vue install', () => ['npm', 'install']);
       add('run', 'Vue dev', () => ['npm', 'run', 'dev']);
       add('build', 'Vue build', () => ['npm', 'run', 'build']);
       add('test', 'Vue test', () => ['npm', 'run', 'test']);
@@ -199,6 +199,7 @@ const builtInFrameworks = [
           commands[key] = {label, command: tokens, source: 'framework'};
         }
       };
+      add('install', 'Nest install', () => ['npm', 'install']);
       add('run', 'Nest dev', () => ['npm', 'run', 'start:dev']);
       add('build', 'Nest build', () => ['npm', 'run', 'build']);
       add('test', 'Nest test', () => ['npm', 'run', 'test']);
@@ -223,6 +224,7 @@ const builtInFrameworks = [
           commands[key] = {label, command: tokens, source: 'framework'};
         }
       };
+      add('install', 'Angular install', () => ['npm', 'install']);
       add('run', 'Angular serve', () => ['npm', 'run', 'start']);
       add('build', 'Angular build', () => ['npm', 'run', 'build']);
       add('test', 'Angular test', () => ['npm', 'run', 'test']);
@@ -247,6 +249,7 @@ const builtInFrameworks = [
           commands[key] = {label, command: tokens, source: 'framework'};
         }
       };
+      add('install', 'SvelteKit install', () => ['npm', 'install']);
       add('run', 'SvelteKit dev', () => ['npm', 'run', 'dev']);
       add('build', 'SvelteKit build', () => ['npm', 'run', 'build']);
       add('test', 'SvelteKit test', () => ['npm', 'run', 'test']);
@@ -272,6 +275,7 @@ const builtInFrameworks = [
           commands[key] = {label, command: tokens, source: 'framework'};
         }
       };
+      add('install', 'Nuxt install', () => ['npm', 'install']);
       add('run', 'Nuxt dev', () => ['npm', 'run', 'dev']);
       add('build', 'Nuxt build', () => ['npm', 'run', 'build']);
       add('start', 'Nuxt start', () => ['npm', 'run', 'start']);
@@ -297,6 +301,7 @@ const builtInFrameworks = [
           commands[key] = {label, command: tokens, source: 'framework'};
         }
       };
+      add('install', 'Astro install', () => ['npm', 'install']);
       add('run', 'Astro dev', () => ['npm', 'run', 'dev']);
       add('build', 'Astro build', () => ['npm', 'run', 'build']);
       add('preview', 'Astro preview', () => ['npm', 'run', 'preview']);
@@ -315,14 +320,16 @@ const builtInFrameworks = [
     },
     commands(project) {
       const managePath = path.join(project.path, 'manage.py');
-      if (!fs.existsSync(managePath)) {
-        return {};
+      const commands = {};
+      if (hasProjectFile(project.path, 'requirements.txt')) {
+        commands.install = {label: 'Pip install', command: ['pip', 'install', '-r', 'requirements.txt'], source: 'framework'};
       }
-      return {
-        run: {label: 'Django runserver', command: ['python', 'manage.py', 'runserver'], source: 'framework'},
-        test: {label: 'Django test', command: ['python', 'manage.py', 'test'], source: 'framework'},
-        migrate: {label: 'Django migrate', command: ['python', 'manage.py', 'migrate'], source: 'framework'}
-      };
+      if (fs.existsSync(managePath)) {
+        commands.run = {label: 'Django runserver', command: ['python', 'manage.py', 'runserver'], source: 'framework'};
+        commands.test = {label: 'Django test', command: ['python', 'manage.py', 'test'], source: 'framework'};
+        commands.migrate = {label: 'Django migrate', command: ['python', 'manage.py', 'migrate'], source: 'framework'};
+      }
+      return commands;
     }
   },
   {
@@ -338,13 +345,15 @@ const builtInFrameworks = [
     },
     commands(project) {
       const entry = findPythonEntry(project.path);
-      if (!entry) {
-        return {};
+      const commands = {};
+      if (hasProjectFile(project.path, 'requirements.txt')) {
+        commands.install = {label: 'Pip install', command: ['pip', 'install', '-r', 'requirements.txt'], source: 'framework'};
       }
-      return {
-        run: {label: 'Flask app', command: ['python', entry], source: 'framework'},
-        test: {label: 'Pytest', command: ['pytest'], source: 'framework'}
-      };
+      if (entry) {
+        commands.run = {label: 'Flask app', command: ['python', entry], source: 'framework'};
+        commands.test = {label: 'Pytest', command: ['pytest'], source: 'framework'};
+      }
+      return commands;
     }
   },
   {
@@ -360,14 +369,16 @@ const builtInFrameworks = [
     },
     commands(project) {
       const entry = findPythonEntry(project.path);
-      if (!entry) {
-        return {};
+      const commands = {};
+      if (hasProjectFile(project.path, 'requirements.txt')) {
+        commands.install = {label: 'Pip install', command: ['pip', 'install', '-r', 'requirements.txt'], source: 'framework'};
       }
-      const moduleName = entry.split('.').slice(0, -1).join('.') || entry;
-      return {
-        run: {label: 'Uvicorn reload', command: ['uvicorn', `${moduleName}:app`, '--reload'], source: 'framework'},
-        test: {label: 'Pytest', command: ['pytest'], source: 'framework'}
-      };
+      if (entry) {
+        const moduleName = entry.split('.').slice(0, -1).join('.') || entry;
+        commands.run = {label: 'Uvicorn reload', command: ['uvicorn', `${moduleName}:app`, '--reload'], source: 'framework'};
+        commands.test = {label: 'Pytest', command: ['pytest'], source: 'framework'};
+      }
+      return commands;
     }
   },
   {
@@ -388,6 +399,7 @@ const builtInFrameworks = [
           commands[key] = {label, command: tokens, source: 'framework'};
         }
       };
+      add('install', 'Vite install', () => ['npm', 'install']);
       add('run', 'Vite dev', () => ['npx', 'vite']);
       add('build', 'Vite build', () => ['npx', 'vite', 'build']);
       add('preview', 'Vite preview', () => ['npx', 'vite', 'preview']);
@@ -404,7 +416,7 @@ const builtInFrameworks = [
     match(project) {
       return hasProjectFile(project.path, 'tailwind.config.js') || hasProjectFile(project.path, 'tailwind.config.ts') || dependencyMatches(project, 'tailwindcss');
     },
-    commands() { return {}; }
+    commands() { return { install: {label: 'Tailwind install', command: ['npm', 'install', '-D', 'tailwindcss'], source: 'framework'} }; }
   },
   {
     id: 'prisma',
@@ -418,6 +430,7 @@ const builtInFrameworks = [
     },
     commands() {
       return {
+        install: {label: 'Prisma install', command: ['npm', 'install', '@prisma/client'], source: 'framework'},
         generate: {label: 'Prisma generate', command: ['npx', 'prisma', 'generate'], source: 'framework'},
         studio: {label: 'Prisma studio', command: ['npx', 'prisma', 'studio'], source: 'framework'}
       };
@@ -441,6 +454,7 @@ const builtInFrameworks = [
       const hasGradlew = hasProjectFile(project.path, 'gradlew');
       if (hasGradlew) {
         return {
+          install: {label: 'Gradle Resolve', command: ['./gradlew', 'dependencies'], source: 'framework'},
           run: {label: 'Gradle BootRun', command: ['./gradlew', 'bootRun'], source: 'framework'},
           build: {label: 'Gradle Build', command: ['./gradlew', 'build'], source: 'framework'},
           test: {label: 'Gradle Test', command: ['./gradlew', 'test'], source: 'framework'}
@@ -448,6 +462,7 @@ const builtInFrameworks = [
       }
       const base = hasMvnw ? './mvnw' : 'mvn';
       return {
+        install: {label: 'Maven Install', command: [base, 'install'], source: 'framework'},
         run: {label: 'Spring Boot run', command: [base, 'spring-boot:run'], source: 'framework'},
         build: {label: 'Maven package', command: [base, 'package'], source: 'framework'},
         test: {label: 'Maven test', command: [base, 'test'], source: 'framework'}
@@ -466,6 +481,7 @@ const builtInFrameworks = [
     },
     commands() {
       return {
+        install: {label: 'Cargo Fetch', command: ['cargo', 'fetch'], source: 'framework'},
         run: {label: 'Rocket Run', command: ['cargo', 'run'], source: 'framework'},
         test: {label: 'Rocket Test', command: ['cargo', 'test'], source: 'framework'}
       };
@@ -483,6 +499,7 @@ const builtInFrameworks = [
     },
     commands() {
       return {
+        install: {label: 'Cargo Fetch', command: ['cargo', 'fetch'], source: 'framework'},
         run: {label: 'Actix Run', command: ['cargo', 'run'], source: 'framework'},
         test: {label: 'Actix Test', command: ['cargo', 'test'], source: 'framework'}
       };
@@ -501,6 +518,7 @@ const builtInFrameworks = [
     },
     commands() {
       return {
+        install: {label: 'dotnet restore', command: ['dotnet', 'restore'], source: 'framework'},
         run: {label: 'dotnet run', command: ['dotnet', 'run'], source: 'framework'},
         watch: {label: 'dotnet watch', command: ['dotnet', 'watch', 'run'], source: 'framework'},
         test: {label: 'dotnet test', command: ['dotnet', 'test'], source: 'framework'}
@@ -519,6 +537,7 @@ const builtInFrameworks = [
     },
     commands() {
       return {
+        install: {label: 'Composer install', command: ['composer', 'install'], source: 'framework'},
         run: {label: 'Artisan Serve', command: ['php', 'artisan', 'serve'], source: 'framework'},
         test: {label: 'Artisan Test', command: ['php', 'artisan', 'test'], source: 'framework'},
         migrate: {label: 'Artisan Migrate', command: ['php', 'artisan', 'migrate'], source: 'framework'}
@@ -568,6 +587,7 @@ class SchemaRegistry {
               }
             }
           };
+          commands.install = {label: 'Install', command: ['npm', 'install']};
           preferScript('build', ['build', 'compile', 'dist'], 'Build');
           preferScript('test', ['test', 'check', 'spec'], 'Test');
           preferScript('run', ['start', 'dev', 'serve', 'run'], 'Start');
@@ -618,6 +638,9 @@ class SchemaRegistry {
         async build(projectPath, manifest) {
           const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           const commands = {};
+          if (hasProjectFile(projectPath, 'requirements.txt')) {
+            commands.install = {label: 'Pip Install', command: ['pip', 'install', '-r', 'requirements.txt']};
+          }
           if (hasProjectFile(projectPath, 'pyproject.toml')) {
             commands.test = {label: 'Pytest', command: ['pytest']};
           } else {
@@ -677,6 +700,7 @@ class SchemaRegistry {
             icon: '🦀',
             priority: this.priority,
             commands: {
+              install: {label: 'Cargo fetch', command: ['cargo', 'fetch']},
               build: {label: 'Cargo build', command: ['cargo', 'build']},
               test: {label: 'Cargo test', command: ['cargo', 'test']},
               run: {label: 'Cargo run', command: ['cargo', 'run']}
@@ -708,6 +732,7 @@ class SchemaRegistry {
             icon: '🐹',
             priority: this.priority,
             commands: {
+              install: {label: 'Go tidy', command: ['go', 'mod', 'tidy']},
               build: {label: 'Go build', command: ['go', 'build', './...']},
               test: {label: 'Go test', command: ['go', 'test', './...']},
               run: {label: 'Go run', command: ['go', 'run', '.']}
@@ -735,9 +760,11 @@ class SchemaRegistry {
           const hasGradlew = hasProjectFile(projectPath, 'gradlew');
           const commands = {};
           if (hasGradlew) {
+            commands.install = {label: 'Gradle resolve', command: ['./gradlew', 'dependencies']};
             commands.build = {label: 'Gradle build', command: ['./gradlew', 'build']};
             commands.test = {label: 'Gradle test', command: ['./gradlew', 'test']};
           } else if (hasMvnw) {
+            commands.install = {label: 'Maven install', command: ['./mvnw', 'install']};
             commands.build = {label: 'Maven package', command: ['./mvnw', 'package']};
             commands.test = {label: 'Maven test', command: ['./mvnw', 'test']};
           } else {
@@ -780,6 +807,7 @@ class SchemaRegistry {
             icon: '🔵',
             priority: this.priority,
             commands: {
+              install: {label: 'sbt update', command: ['sbt', 'update']},
               build: {label: 'sbt compile', command: ['sbt', 'compile']},
               test: {label: 'sbt test', command: ['sbt', 'test']},
               run: {label: 'sbt run', command: ['sbt', 'run']}
@@ -811,6 +839,7 @@ class SchemaRegistry {
             icon: '🐘',
             priority: this.priority,
             commands: {
+              install: {label: 'Composer install', command: ['composer', 'install']},
               test: {label: 'PHP -v', command: ['php', '-v']}
             },
             metadata: {},
@@ -840,6 +869,7 @@ class SchemaRegistry {
             icon: '💎',
             priority: this.priority,
             commands: {
+              install: {label: 'Bundle install', command: ['bundle', 'install']},
               run: {label: 'Ruby console', command: ['ruby', 'app.rb']},
               test: {label: 'Ruby test', command: ['bundle', 'exec', 'rspec']}
             },
@@ -870,6 +900,7 @@ class SchemaRegistry {
             icon: '🔷',
             priority: this.priority,
             commands: {
+              install: {label: 'dotnet restore', command: ['dotnet', 'restore']},
               build: {label: 'dotnet build', command: ['dotnet', 'build']},
               test: {label: 'dotnet test', command: ['dotnet', 'test']},
               run: {label: 'dotnet run', command: ['dotnet', 'run']}