@austinthesing/magic-shell 0.1.3 → 0.2.0

package/README.md

@@ -8,8 +8,10 @@ Magic Shell is an open-source CLI tool that translates plain English (or any nat
 
 - **Natural Language Translation**: Describe what you want to do in plain English
 - **Multiple AI Providers**: OpenCode Zen (with free models!) and OpenRouter
+- **Project Context Aware**: Opt-in detection of package.json scripts, Makefile targets, etc.
 - **Interactive TUI Mode**: Full-featured terminal interface with themes
 - **Command Safety Analysis**: Multi-level safety checks before executing commands
+- **Auto Updates**: Automatic update checking with one-command upgrades
 - **Cross-Platform**: macOS, Linux, and Windows support
 - **Shell-Aware**: Automatically detects and adapts to your shell (bash, zsh, fish, PowerShell, etc.)
 - **Secure Credential Storage**: Uses system keychain (macOS Keychain, Linux secret-tool, Windows Credential Manager)
@@ -18,38 +20,20 @@ Magic Shell is an open-source CLI tool that translates plain English (or any nat
 
 ## Installation
 
-### Quick Install (Recommended)
+### Via Package Manager (Recommended)
 
-**macOS / Linux:**
 ```bash
-curl -fsSL https://raw.githubusercontent.com/austin-thesing/magic-shell/main/install.sh | bash
-```
-
-**Windows (PowerShell):**
-```powershell
-irm https://raw.githubusercontent.com/austin-thesing/magic-shell/main/install.ps1 | iex
-```
-
-### Via Package Manager
-
-```bash
-# Install globally with bun (recommended)
+# bun (recommended)
 bun add -g @austinthesing/magic-shell
 
-# Or with npm
+# npm
 npm install -g @austinthesing/magic-shell
 
-# Or with yarn
-yarn global add @austinthesing/magic-shell
-
-# Or with pnpm
+# pnpm
 pnpm add -g @austinthesing/magic-shell
-```
 
-### Via Homebrew (macOS/Linux)
-
-```bash
-brew install austin-thesing/tap/magic-shell
+# yarn
+yarn global add @austinthesing/magic-shell
 ```
 
 ### From Source
@@ -118,6 +102,10 @@ msh
 | `msh --provider <name>` | Set provider (opencode-zen or openrouter) |
 | `msh --themes` | List available themes |
 | `msh --theme <name>` | Set color theme |
+| `msh --repo-context` | Enable project context detection |
+| `msh -r <query>` | Use project context for single query |
+| `msh --version` | Show version |
+| `msh --check-update` | Check for updates |
 | `msh --help` | Show help |
 
 ### Examples
@@ -160,6 +148,7 @@ All shortcuts use the `Ctrl+X` chord (press Ctrl+X, then the key):
 | `Ctrl+X S` | Switch provider |
 | `Ctrl+X D` | Toggle dry-run mode |
 | `Ctrl+X T` | Change theme |
+| `Ctrl+X R` | Toggle project context |
 | `Ctrl+X H` | Show history |
 | `Ctrl+X C` | Show config |
 | `Ctrl+X L` | Clear output |
@@ -257,9 +246,10 @@ Configuration is stored in `~/.magic-shell/config.json`.
 ```json
 {
   "provider": "opencode-zen",
-  "defaultModel": "grok-code",
+  "defaultModel": "gemini-3-flash",
   "safetyLevel": "moderate",
   "dryRunByDefault": false,
+  "repoContext": false,
   "theme": "opencode",
   "blockedCommands": [...],
   "confirmedDangerousPatterns": [...]

package/dist/cli.js

@@ -21116,7 +21116,7 @@ var init_config = __esm(() => {
     provider: "opencode-zen",
     openrouterApiKey: "",
     opencodeZenApiKey: "",
-    defaultModel: "gpt-5-nano",
+    defaultModel: "gemini-3-flash",
     safetyLevel: "moderate",
     dryRunByDefault: false,
     blockedCommands: [
@@ -21127,7 +21127,8 @@ var init_config = __esm(() => {
       "chmod -R 777 /",
       "chown -R"
     ],
-    confirmedDangerousPatterns: []
+    confirmedDangerousPatterns: [],
+    repoContext: false
   };
 });
 
@@ -21472,6 +21473,112 @@ function getPlatformPaths(platform) {
 }
 var init_shell = () => {};
 
+// src/lib/repo-context.ts
+import { existsSync as existsSync6, readFileSync as readFileSync2 } from "fs";
+import { join as join3 } from "path";
+function detectRepoContext(cwd) {
+  const context = {
+    type: "unknown"
+  };
+  let detected = false;
+  if (existsSync6(join3(cwd, ".git"))) {
+    context.hasGit = true;
+    detected = true;
+  }
+  if (existsSync6(join3(cwd, "Dockerfile")) || existsSync6(join3(cwd, "docker-compose.yml")) || existsSync6(join3(cwd, "docker-compose.yaml"))) {
+    context.hasDocker = true;
+    detected = true;
+  }
+  const packageJsonPath = join3(cwd, "package.json");
+  if (existsSync6(packageJsonPath)) {
+    detected = true;
+    context.type = "node";
+    try {
+      const packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf-8"));
+      if (existsSync6(join3(cwd, "bun.lockb")) || existsSync6(join3(cwd, "bun.lock"))) {
+        context.packageManager = "bun";
+      } else if (existsSync6(join3(cwd, "pnpm-lock.yaml"))) {
+        context.packageManager = "pnpm";
+      } else if (existsSync6(join3(cwd, "yarn.lock"))) {
+        context.packageManager = "yarn";
+      } else if (existsSync6(join3(cwd, "package-lock.json"))) {
+        context.packageManager = "npm";
+      } else if (packageJson.packageManager) {
+        const pm = packageJson.packageManager.split("@")[0];
+        context.packageManager = pm;
+      }
+      if (packageJson.scripts && typeof packageJson.scripts === "object") {
+        context.scripts = Object.keys(packageJson.scripts);
+      }
+    } catch {}
+  }
+  const makefilePath = join3(cwd, "Makefile");
+  if (existsSync6(makefilePath)) {
+    detected = true;
+    if (context.type === "unknown")
+      context.type = "make";
+    try {
+      const makefile = readFileSync2(makefilePath, "utf-8");
+      const targetRegex = /^([a-zA-Z_][a-zA-Z0-9_-]*)\s*:/gm;
+      const targets = [];
+      let match;
+      while ((match = targetRegex.exec(makefile)) !== null) {
+        if (!match[1].startsWith(".") && !match[1].startsWith("_")) {
+          targets.push(match[1]);
+        }
+      }
+      if (targets.length > 0) {
+        context.makeTargets = [...new Set(targets)];
+      }
+    } catch {}
+  }
+  if (existsSync6(join3(cwd, "Cargo.toml"))) {
+    detected = true;
+    context.type = "rust";
+    context.cargoCommands = ["build", "run", "test", "check", "clippy", "fmt", "doc"];
+  }
+  if (existsSync6(join3(cwd, "pyproject.toml")) || existsSync6(join3(cwd, "setup.py")) || existsSync6(join3(cwd, "requirements.txt"))) {
+    detected = true;
+    if (context.type === "unknown")
+      context.type = "python";
+  }
+  if (existsSync6(join3(cwd, "go.mod"))) {
+    detected = true;
+    if (context.type === "unknown")
+      context.type = "go";
+  }
+  return detected ? context : null;
+}
+function formatRepoContext(context) {
+  const lines = [];
+  lines.push(`Project type: ${context.type}`);
+  if (context.packageManager) {
+    lines.push(`Package manager: ${context.packageManager}`);
+  }
+  if (context.scripts && context.scripts.length > 0) {
+    const displayScripts = context.scripts.slice(0, 15);
+    const suffix = context.scripts.length > 15 ? ` (+${context.scripts.length - 15} more)` : "";
+    lines.push(`Available scripts: ${displayScripts.join(", ")}${suffix}`);
+  }
+  if (context.makeTargets && context.makeTargets.length > 0) {
+    const displayTargets = context.makeTargets.slice(0, 15);
+    const suffix = context.makeTargets.length > 15 ? ` (+${context.makeTargets.length - 15} more)` : "";
+    lines.push(`Make targets: ${displayTargets.join(", ")}${suffix}`);
+  }
+  if (context.cargoCommands) {
+    lines.push(`Cargo commands: ${context.cargoCommands.join(", ")}`);
+  }
+  if (context.hasDocker) {
+    lines.push(`Docker: available`);
+  }
+  if (context.hasGit) {
+    lines.push(`Git: initialized`);
+  }
+  return lines.join(`
+`);
+}
+var init_repo_context = () => {};
+
 // src/lib/api.ts
 function getZenApiType(modelId) {
   if (modelId.startsWith("gpt-")) {
@@ -21485,11 +21592,21 @@ function getZenApiType(modelId) {
   }
   return "openai-compatible";
 }
-function buildSystemPrompt(cwd, history, shellInfo) {
+function buildSystemPrompt(cwd, history, shellInfo, repoContextEnabled) {
   const historyContext = formatHistory(history);
   const platformPaths = getPlatformPaths(shellInfo.platform);
   const shellHints = getShellSyntaxHints(shellInfo.shell);
   const platformName = shellInfo.platform === "macos" ? "macOS" : shellInfo.platform === "windows" ? "Windows" : shellInfo.platform === "linux" ? shellInfo.isWSL ? "Linux (WSL)" : "Linux" : "Unknown";
+  let projectContextSection = "";
+  if (repoContextEnabled) {
+    const repoContext = detectRepoContext(cwd);
+    if (repoContext) {
+      projectContextSection = `
+Project context:
+${formatRepoContext(repoContext)}
+`;
+    }
+  }
   return `You are a shell command translator. Convert the user's natural language request into a shell command.
 
 Current environment:
@@ -21498,7 +21615,7 @@ Current environment:
 - Working directory: ${cwd}
 - Home directory: ${shellInfo.homeDir}
 ${shellInfo.terminalEmulator ? `- Terminal: ${shellInfo.terminalEmulator}` : ""}
-
+${projectContextSection}
 ${shellHints}
 
 Recent command history:
@@ -21509,7 +21626,8 @@ Rules:
 - No explanations, no markdown, no backticks, no code blocks
 - Use the correct syntax for the detected shell (${shellInfo.shell})
 - If the request is unclear, make a reasonable assumption
-- Prefer simple, common commands over complex one-liners
+- Prefer simple, common commands over complex one-liners${repoContextEnabled ? `
+- Use project-specific commands when relevant (e.g., use the detected package manager and available scripts)` : ""}
 - Use the command history for context (e.g., "do that again", "undo", "delete the file I just created")
 - If the user asks something that can't be done with a shell command, output a command that prints a helpful message
 - For file operations, prefer safer alternatives when possible
@@ -21781,9 +21899,9 @@ function getShellInfo() {
   }
   return cachedShellInfo;
 }
-async function translateToCommand(apiKey, model, userInput, cwd, history = []) {
+async function translateToCommand(apiKey, model, userInput, cwd, history = [], repoContextEnabled) {
   const shellInfo = getShellInfo();
-  const systemPrompt = buildSystemPrompt(cwd, history, shellInfo);
+  const systemPrompt = buildSystemPrompt(cwd, history, shellInfo, repoContextEnabled);
   let rawCommand;
   if (model.provider === "openrouter") {
     rawCommand = await callOpenRouter(apiKey, model.id, systemPrompt, userInput);
@@ -21809,6 +21927,7 @@ async function translateToCommand(apiKey, model, userInput, cwd, history = []) {
 var DEBUG_API, cachedShellInfo = null;
 var init_api = __esm(() => {
   init_shell();
+  init_repo_context();
   DEBUG_API = process.env.DEBUG_API === "1";
 });
 
@@ -22306,7 +22425,8 @@ function getStatusBarContent() {
   const theme = getTheme();
   const providerName = config.provider === "opencode-zen" ? "OpenCode Zen" : "OpenRouter";
   const safeModeIndicator = dryRunMode ? fg(theme.colors.warning)("[DRY RUN]") : fg(theme.colors.success)("Safe");
-  return t`${fg(theme.colors.textMuted)("Provider:")} ${fg(theme.colors.text)(providerName)}  ${fg(theme.colors.textMuted)("Model:")} ${fg(theme.colors.text)(currentModel.name)}  ${safeModeIndicator}`;
+  const repoContextIndicator = config.repoContext ? fg(theme.colors.info)("[Repo]") : "";
+  return t`${fg(theme.colors.textMuted)("Provider:")} ${fg(theme.colors.text)(providerName)}  ${fg(theme.colors.textMuted)("Model:")} ${fg(theme.colors.text)(currentModel.name)}  ${safeModeIndicator}${repoContextIndicator ? " " : ""}${repoContextIndicator}`;
 }
 function getHelpBarContent() {
   const theme = getTheme();
@@ -22636,7 +22756,7 @@ async function translateAndProcess(input) {
   }
   const loadingMsg = addSystemMessage("Translating...");
   try {
-    const command = await translateToCommand(apiKey, currentModel, input, currentCwd, history);
+    const command = await translateToCommand(apiKey, currentModel, input, currentCwd, history, config.repoContext);
     chatScrollBox.remove(`msg-${loadingMsg.id}`);
     chatMessages = chatMessages.filter((m) => m.id !== loadingMsg.id);
     const safety = analyzeCommand(command, config);
@@ -22786,9 +22906,10 @@ function showHelp() {
   const helpText = `Keyboard Shortcuts (Ctrl+X then...):
 P  Command palette    M  Change model
 S  Switch provider    D  Toggle dry-run
-T  Change theme       H  Show history
-C  Show config        L  Clear chat
-?  This help          Q  Exit
+T  Change theme       R  Toggle repo context
+H  Show history       L  Clear chat
+C  Show config        ?  This help
+Q  Exit
 
 Other:
 Ctrl+C  Exit / Cancel     Esc  Close palette
@@ -22796,7 +22917,7 @@ Ctrl+C  Exit / Cancel     Esc  Close palette
 Tips:
 - Type naturally: "list all files" -> ls -la
 - Reference history: "do that again", "undo"
-- Free models: gpt-5-nano, grok-code, glm-4.7-free`;
+- Enable repo context to use project scripts (Ctrl+X R)`;
   addSystemMessage(helpText);
 }
 async function showConfig() {
@@ -22817,6 +22938,7 @@ Shell:        ${shellInfo.shell} (${shellInfo.shellPath})
 Platform:     ${shellInfo.platform}${shellInfo.isWSL ? " (WSL)" : ""}
 Safety:       ${config.safetyLevel}
 Dry-run:      ${dryRunMode ? "ON" : "OFF"}
+Repo context: ${config.repoContext ? "ON" : "OFF"}
 API Key:      ${apiKeyStatus}
 History:      ${history.length} commands`;
   addSystemMessage(configText);
@@ -23079,6 +23201,18 @@ function getCommandPaletteOptions() {
         addSystemMessage(`Dry-run mode: ${dryRunMode ? "ON" : "OFF"}`);
       }
     },
+    {
+      name: "Toggle Project Context",
+      description: config.repoContext ? "Currently ON (sends script names to AI)" : "Currently OFF",
+      key: "r",
+      chord: "r",
+      action: () => {
+        config.repoContext = !config.repoContext;
+        saveConfig(config);
+        statusBarText.content = getStatusBarContent();
+        addSystemMessage(`Project context: ${config.repoContext ? "ON - AI can see your package.json scripts, Makefile targets, etc." : "OFF"}`);
+      }
+    },
     {
       name: "Show Config",
       description: "View current configuration",

package/dist/index.js

@@ -518,22 +518,128 @@ function getPlatformPaths(platform) {
 }
 var init_shell = () => {};
 
+// src/lib/repo-context.ts
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
+import { join as join2 } from "path";
+function detectRepoContext(cwd) {
+  const context = {
+    type: "unknown"
+  };
+  let detected = false;
+  if (existsSync3(join2(cwd, ".git"))) {
+    context.hasGit = true;
+    detected = true;
+  }
+  if (existsSync3(join2(cwd, "Dockerfile")) || existsSync3(join2(cwd, "docker-compose.yml")) || existsSync3(join2(cwd, "docker-compose.yaml"))) {
+    context.hasDocker = true;
+    detected = true;
+  }
+  const packageJsonPath = join2(cwd, "package.json");
+  if (existsSync3(packageJsonPath)) {
+    detected = true;
+    context.type = "node";
+    try {
+      const packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf-8"));
+      if (existsSync3(join2(cwd, "bun.lockb")) || existsSync3(join2(cwd, "bun.lock"))) {
+        context.packageManager = "bun";
+      } else if (existsSync3(join2(cwd, "pnpm-lock.yaml"))) {
+        context.packageManager = "pnpm";
+      } else if (existsSync3(join2(cwd, "yarn.lock"))) {
+        context.packageManager = "yarn";
+      } else if (existsSync3(join2(cwd, "package-lock.json"))) {
+        context.packageManager = "npm";
+      } else if (packageJson.packageManager) {
+        const pm = packageJson.packageManager.split("@")[0];
+        context.packageManager = pm;
+      }
+      if (packageJson.scripts && typeof packageJson.scripts === "object") {
+        context.scripts = Object.keys(packageJson.scripts);
+      }
+    } catch {}
+  }
+  const makefilePath = join2(cwd, "Makefile");
+  if (existsSync3(makefilePath)) {
+    detected = true;
+    if (context.type === "unknown")
+      context.type = "make";
+    try {
+      const makefile = readFileSync2(makefilePath, "utf-8");
+      const targetRegex = /^([a-zA-Z_][a-zA-Z0-9_-]*)\s*:/gm;
+      const targets = [];
+      let match;
+      while ((match = targetRegex.exec(makefile)) !== null) {
+        if (!match[1].startsWith(".") && !match[1].startsWith("_")) {
+          targets.push(match[1]);
+        }
+      }
+      if (targets.length > 0) {
+        context.makeTargets = [...new Set(targets)];
+      }
+    } catch {}
+  }
+  if (existsSync3(join2(cwd, "Cargo.toml"))) {
+    detected = true;
+    context.type = "rust";
+    context.cargoCommands = ["build", "run", "test", "check", "clippy", "fmt", "doc"];
+  }
+  if (existsSync3(join2(cwd, "pyproject.toml")) || existsSync3(join2(cwd, "setup.py")) || existsSync3(join2(cwd, "requirements.txt"))) {
+    detected = true;
+    if (context.type === "unknown")
+      context.type = "python";
+  }
+  if (existsSync3(join2(cwd, "go.mod"))) {
+    detected = true;
+    if (context.type === "unknown")
+      context.type = "go";
+  }
+  return detected ? context : null;
+}
+function formatRepoContext(context) {
+  const lines = [];
+  lines.push(`Project type: ${context.type}`);
+  if (context.packageManager) {
+    lines.push(`Package manager: ${context.packageManager}`);
+  }
+  if (context.scripts && context.scripts.length > 0) {
+    const displayScripts = context.scripts.slice(0, 15);
+    const suffix = context.scripts.length > 15 ? ` (+${context.scripts.length - 15} more)` : "";
+    lines.push(`Available scripts: ${displayScripts.join(", ")}${suffix}`);
+  }
+  if (context.makeTargets && context.makeTargets.length > 0) {
+    const displayTargets = context.makeTargets.slice(0, 15);
+    const suffix = context.makeTargets.length > 15 ? ` (+${context.makeTargets.length - 15} more)` : "";
+    lines.push(`Make targets: ${displayTargets.join(", ")}${suffix}`);
+  }
+  if (context.cargoCommands) {
+    lines.push(`Cargo commands: ${context.cargoCommands.join(", ")}`);
+  }
+  if (context.hasDocker) {
+    lines.push(`Docker: available`);
+  }
+  if (context.hasGit) {
+    lines.push(`Git: initialized`);
+  }
+  return lines.join(`
+`);
+}
+var init_repo_context = () => {};
+
 // src/lib/config.ts
 import { homedir as homedir3 } from "os";
-import { join as join2 } from "path";
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { join as join3 } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
 function ensureConfigDir2() {
-  if (!existsSync3(CONFIG_DIR2)) {
+  if (!existsSync4(CONFIG_DIR2)) {
     mkdirSync2(CONFIG_DIR2, { recursive: true });
   }
 }
 function loadConfig2() {
   ensureConfigDir2();
-  if (!existsSync3(CONFIG_FILE2)) {
+  if (!existsSync4(CONFIG_FILE2)) {
     return { ...DEFAULT_CONFIG2 };
   }
   try {
-    const data = readFileSync2(CONFIG_FILE2, "utf-8");
+    const data = readFileSync3(CONFIG_FILE2, "utf-8");
     const loaded = JSON.parse(data);
     return { ...DEFAULT_CONFIG2, ...loaded };
   } catch {
@@ -582,11 +688,11 @@ async function setApiKey2(provider, key) {
 }
 function loadHistory2() {
   ensureConfigDir2();
-  if (!existsSync3(HISTORY_FILE2)) {
+  if (!existsSync4(HISTORY_FILE2)) {
     return [];
   }
   try {
-    const data = readFileSync2(HISTORY_FILE2, "utf-8");
+    const data = readFileSync3(HISTORY_FILE2, "utf-8");
     return JSON.parse(data);
   } catch {
     return [];
@@ -605,14 +711,14 @@ function addToHistory(entry) {
 var CONFIG_DIR2, CONFIG_FILE2, HISTORY_FILE2, KEYCHAIN_OPENROUTER2 = "openrouter-api-key", KEYCHAIN_OPENCODE_ZEN2 = "opencode-zen-api-key", DEFAULT_CONFIG2;
 var init_config = __esm(() => {
   init_keychain();
-  CONFIG_DIR2 = join2(homedir3(), ".magic-shell");
-  CONFIG_FILE2 = join2(CONFIG_DIR2, "config.json");
-  HISTORY_FILE2 = join2(CONFIG_DIR2, "history.json");
+  CONFIG_DIR2 = join3(homedir3(), ".magic-shell");
+  CONFIG_FILE2 = join3(CONFIG_DIR2, "config.json");
+  HISTORY_FILE2 = join3(CONFIG_DIR2, "history.json");
   DEFAULT_CONFIG2 = {
     provider: "opencode-zen",
     openrouterApiKey: "",
     opencodeZenApiKey: "",
-    defaultModel: "gpt-5-nano",
+    defaultModel: "gemini-3-flash",
     safetyLevel: "moderate",
     dryRunByDefault: false,
     blockedCommands: [
@@ -623,7 +729,8 @@ var init_config = __esm(() => {
       "chmod -R 777 /",
       "chown -R"
     ],
-    confirmedDangerousPatterns: []
+    confirmedDangerousPatterns: [],
+    repoContext: false
   };
 });
 
@@ -679,8 +786,8 @@ import { EventEmitter as EventEmitter3 } from "events";
 import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 import { resolve as resolve2, isAbsolute, parse } from "path";
-import { existsSync as existsSync4 } from "fs";
-import { basename, join as join3 } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { basename, join as join5 } from "path";
 import os from "os";
 import path from "path";
 import { EventEmitter as EventEmitter4 } from "events";
@@ -2042,7 +2149,7 @@ function getBunfsRootPath() {
   return process.platform === "win32" ? "B:\\~BUN\\root" : "/$bunfs/root";
 }
 function normalizeBunfsPath(fileName) {
-  return join3(getBunfsRootPath(), basename(fileName));
+  return join5(getBunfsRootPath(), basename(fileName));
 }
 function isValidDirectoryName(name) {
   if (!name || typeof name !== "string") {
@@ -11901,7 +12008,7 @@ var init_index_93qf6w1k = __esm(async () => {
         worker_path = this.options.workerPath;
       } else {
         worker_path = new URL("./parser.worker.js", import.meta.url).href;
-        if (!existsSync4(resolve2(import.meta.dirname, "parser.worker.js"))) {
+        if (!existsSync6(resolve2(import.meta.dirname, "parser.worker.js"))) {
           worker_path = new URL("./parser.worker.ts", import.meta.url).href;
         }
       }
@@ -21486,11 +21593,21 @@ function getZenApiType2(modelId) {
   }
   return "openai-compatible";
 }
-function buildSystemPrompt2(cwd, history, shellInfo) {
+function buildSystemPrompt2(cwd, history, shellInfo, repoContextEnabled) {
   const historyContext = formatHistory2(history);
   const platformPaths = getPlatformPaths(shellInfo.platform);
   const shellHints = getShellSyntaxHints(shellInfo.shell);
   const platformName = shellInfo.platform === "macos" ? "macOS" : shellInfo.platform === "windows" ? "Windows" : shellInfo.platform === "linux" ? shellInfo.isWSL ? "Linux (WSL)" : "Linux" : "Unknown";
+  let projectContextSection = "";
+  if (repoContextEnabled) {
+    const repoContext = detectRepoContext(cwd);
+    if (repoContext) {
+      projectContextSection = `
+Project context:
+${formatRepoContext(repoContext)}
+`;
+    }
+  }
   return `You are a shell command translator. Convert the user's natural language request into a shell command.
 
 Current environment:
@@ -21499,7 +21616,7 @@ Current environment:
 - Working directory: ${cwd}
 - Home directory: ${shellInfo.homeDir}
 ${shellInfo.terminalEmulator ? `- Terminal: ${shellInfo.terminalEmulator}` : ""}
-
+${projectContextSection}
 ${shellHints}
 
 Recent command history:
@@ -21510,7 +21627,8 @@ Rules:
 - No explanations, no markdown, no backticks, no code blocks
 - Use the correct syntax for the detected shell (${shellInfo.shell})
 - If the request is unclear, make a reasonable assumption
-- Prefer simple, common commands over complex one-liners
+- Prefer simple, common commands over complex one-liners${repoContextEnabled ? `
+- Use project-specific commands when relevant (e.g., use the detected package manager and available scripts)` : ""}
 - Use the command history for context (e.g., "do that again", "undo", "delete the file I just created")
 - If the user asks something that can't be done with a shell command, output a command that prints a helpful message
 - For file operations, prefer safer alternatives when possible
@@ -21782,9 +21900,9 @@ function getShellInfo2() {
   }
   return cachedShellInfo2;
 }
-async function translateToCommand2(apiKey, model, userInput, cwd, history = []) {
+async function translateToCommand2(apiKey, model, userInput, cwd, history = [], repoContextEnabled) {
   const shellInfo = getShellInfo2();
-  const systemPrompt = buildSystemPrompt2(cwd, history, shellInfo);
+  const systemPrompt = buildSystemPrompt2(cwd, history, shellInfo, repoContextEnabled);
   let rawCommand;
   if (model.provider === "openrouter") {
     rawCommand = await callOpenRouter2(apiKey, model.id, systemPrompt, userInput);
@@ -21810,6 +21928,7 @@ async function translateToCommand2(apiKey, model, userInput, cwd, history = [])
 var DEBUG_API2, cachedShellInfo2 = null;
 var init_api = __esm(() => {
   init_shell();
+  init_repo_context();
   DEBUG_API2 = process.env.DEBUG_API === "1";
 });
 
@@ -22287,7 +22406,8 @@ function getStatusBarContent() {
   const theme = getTheme2();
   const providerName = config.provider === "opencode-zen" ? "OpenCode Zen" : "OpenRouter";
   const safeModeIndicator = dryRunMode ? fg(theme.colors.warning)("[DRY RUN]") : fg(theme.colors.success)("Safe");
-  return t`${fg(theme.colors.textMuted)("Provider:")} ${fg(theme.colors.text)(providerName)}  ${fg(theme.colors.textMuted)("Model:")} ${fg(theme.colors.text)(currentModel.name)}  ${safeModeIndicator}`;
+  const repoContextIndicator = config.repoContext ? fg(theme.colors.info)("[Repo]") : "";
+  return t`${fg(theme.colors.textMuted)("Provider:")} ${fg(theme.colors.text)(providerName)}  ${fg(theme.colors.textMuted)("Model:")} ${fg(theme.colors.text)(currentModel.name)}  ${safeModeIndicator}${repoContextIndicator ? " " : ""}${repoContextIndicator}`;
 }
 function getHelpBarContent() {
   const theme = getTheme2();
@@ -22617,7 +22737,7 @@ async function translateAndProcess(input) {
   }
   const loadingMsg = addSystemMessage("Translating...");
   try {
-    const command = await translateToCommand2(apiKey, currentModel, input, currentCwd, history);
+    const command = await translateToCommand2(apiKey, currentModel, input, currentCwd, history, config.repoContext);
     chatScrollBox.remove(`msg-${loadingMsg.id}`);
     chatMessages = chatMessages.filter((m) => m.id !== loadingMsg.id);
     const safety = analyzeCommand2(command, config);
@@ -22767,9 +22887,10 @@ function showHelp() {
   const helpText = `Keyboard Shortcuts (Ctrl+X then...):
 P  Command palette    M  Change model
 S  Switch provider    D  Toggle dry-run
-T  Change theme       H  Show history
-C  Show config        L  Clear chat
-?  This help          Q  Exit
+T  Change theme       R  Toggle repo context
+H  Show history       L  Clear chat
+C  Show config        ?  This help
+Q  Exit
 
 Other:
 Ctrl+C  Exit / Cancel     Esc  Close palette
@@ -22777,7 +22898,7 @@ Ctrl+C  Exit / Cancel     Esc  Close palette
 Tips:
 - Type naturally: "list all files" -> ls -la
 - Reference history: "do that again", "undo"
-- Free models: gpt-5-nano, grok-code, glm-4.7-free`;
+- Enable repo context to use project scripts (Ctrl+X R)`;
   addSystemMessage(helpText);
 }
 async function showConfig() {
@@ -22798,6 +22919,7 @@ Shell:        ${shellInfo.shell} (${shellInfo.shellPath})
 Platform:     ${shellInfo.platform}${shellInfo.isWSL ? " (WSL)" : ""}
 Safety:       ${config.safetyLevel}
 Dry-run:      ${dryRunMode ? "ON" : "OFF"}
+Repo context: ${config.repoContext ? "ON" : "OFF"}
 API Key:      ${apiKeyStatus}
 History:      ${history.length} commands`;
   addSystemMessage(configText);
@@ -23057,6 +23179,18 @@ function getCommandPaletteOptions() {
         addSystemMessage(`Dry-run mode: ${dryRunMode ? "ON" : "OFF"}`);
       }
     },
+    {
+      name: "Toggle Project Context",
+      description: config.repoContext ? "Currently ON (sends script names to AI)" : "Currently OFF",
+      key: "r",
+      chord: "r",
+      action: () => {
+        config.repoContext = !config.repoContext;
+        saveConfig2(config);
+        statusBarText.content = getStatusBarContent();
+        addSystemMessage(`Project context: ${config.repoContext ? "ON - AI can see your package.json scripts, Makefile targets, etc." : "OFF"}`);
+      }
+    },
     {
       name: "Show Config",
       description: "View current configuration",
@@ -23582,7 +23716,7 @@ var DEFAULT_CONFIG = {
   provider: "opencode-zen",
   openrouterApiKey: "",
   opencodeZenApiKey: "",
-  defaultModel: "gpt-5-nano",
+  defaultModel: "gemini-3-flash",
   safetyLevel: "moderate",
   dryRunByDefault: false,
   blockedCommands: [
@@ -23593,7 +23727,8 @@ var DEFAULT_CONFIG = {
     "chmod -R 777 /",
     "chown -R"
   ],
-  confirmedDangerousPatterns: []
+  confirmedDangerousPatterns: [],
+  repoContext: false
 };
 function ensureConfigDir() {
   if (!existsSync(CONFIG_DIR)) {
@@ -23794,6 +23929,7 @@ function getSeverityMessage(severity) {
 
 // src/lib/api.ts
 init_shell();
+init_repo_context();
 function getZenApiType(modelId) {
   if (modelId.startsWith("gpt-")) {
     return "openai-responses";
@@ -23806,11 +23942,21 @@ function getZenApiType(modelId) {
   }
   return "openai-compatible";
 }
-function buildSystemPrompt(cwd, history, shellInfo) {
+function buildSystemPrompt(cwd, history, shellInfo, repoContextEnabled) {
   const historyContext = formatHistory(history);
   const platformPaths = getPlatformPaths(shellInfo.platform);
   const shellHints = getShellSyntaxHints(shellInfo.shell);
   const platformName = shellInfo.platform === "macos" ? "macOS" : shellInfo.platform === "windows" ? "Windows" : shellInfo.platform === "linux" ? shellInfo.isWSL ? "Linux (WSL)" : "Linux" : "Unknown";
+  let projectContextSection = "";
+  if (repoContextEnabled) {
+    const repoContext = detectRepoContext(cwd);
+    if (repoContext) {
+      projectContextSection = `
+Project context:
+${formatRepoContext(repoContext)}
+`;
+    }
+  }
   return `You are a shell command translator. Convert the user's natural language request into a shell command.
 
 Current environment:
@@ -23819,7 +23965,7 @@ Current environment:
 - Working directory: ${cwd}
 - Home directory: ${shellInfo.homeDir}
 ${shellInfo.terminalEmulator ? `- Terminal: ${shellInfo.terminalEmulator}` : ""}
-
+${projectContextSection}
 ${shellHints}
 
 Recent command history:
@@ -23830,7 +23976,8 @@ Rules:
 - No explanations, no markdown, no backticks, no code blocks
 - Use the correct syntax for the detected shell (${shellInfo.shell})
 - If the request is unclear, make a reasonable assumption
-- Prefer simple, common commands over complex one-liners
+- Prefer simple, common commands over complex one-liners${repoContextEnabled ? `
+- Use project-specific commands when relevant (e.g., use the detected package manager and available scripts)` : ""}
 - Use the command history for context (e.g., "do that again", "undo", "delete the file I just created")
 - If the user asks something that can't be done with a shell command, output a command that prints a helpful message
 - For file operations, prefer safer alternatives when possible
@@ -24104,9 +24251,9 @@ function getShellInfo() {
   }
   return cachedShellInfo;
 }
-async function translateToCommand(apiKey, model, userInput, cwd, history = []) {
+async function translateToCommand(apiKey, model, userInput, cwd, history = [], repoContextEnabled) {
   const shellInfo = getShellInfo();
-  const systemPrompt = buildSystemPrompt(cwd, history, shellInfo);
+  const systemPrompt = buildSystemPrompt(cwd, history, shellInfo, repoContextEnabled);
   let rawCommand;
   if (model.provider === "openrouter") {
     rawCommand = await callOpenRouter(apiKey, model.id, systemPrompt, userInput);
@@ -24347,6 +24494,128 @@ function getAnsiColors() {
 }
 loadTheme();
 
+// src/lib/update-checker.ts
+import { homedir as homedir4 } from "os";
+import { join as join4 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
+var __dirname = "/Users/austin/code/dxd/magic-shell/src/lib";
+var PACKAGE_NAME = "@austinthesing/magic-shell";
+var NPM_REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+var CONFIG_DIR3 = join4(homedir4(), ".magic-shell");
+var UPDATE_CHECK_FILE = join4(CONFIG_DIR3, ".update-check");
+function ensureConfigDir3() {
+  if (!existsSync5(CONFIG_DIR3)) {
+    mkdirSync3(CONFIG_DIR3, { recursive: true });
+  }
+}
+function loadUpdateState() {
+  ensureConfigDir3();
+  try {
+    if (existsSync5(UPDATE_CHECK_FILE)) {
+      return JSON.parse(readFileSync4(UPDATE_CHECK_FILE, "utf-8"));
+    }
+  } catch {}
+  return { lastCheck: 0, latestVersion: null, dismissed: null };
+}
+function saveUpdateState(state) {
+  ensureConfigDir3();
+  try {
+    writeFileSync3(UPDATE_CHECK_FILE, JSON.stringify(state));
+  } catch {}
+}
+function getCurrentVersion() {
+  try {
+    const packagePaths = [
+      join4(__dirname, "../../package.json"),
+      join4(__dirname, "../../../package.json"),
+      join4(process.cwd(), "package.json")
+    ];
+    for (const path of packagePaths) {
+      if (existsSync5(path)) {
+        const pkg = JSON.parse(readFileSync4(path, "utf-8"));
+        if (pkg.name === PACKAGE_NAME || pkg.name === "magic-shell") {
+          return pkg.version;
+        }
+      }
+    }
+  } catch {}
+  return "0.0.0";
+}
+function compareVersions(a, b) {
+  const partsA = a.split(".").map(Number);
+  const partsB = b.split(".").map(Number);
+  for (let i = 0;i < Math.max(partsA.length, partsB.length); i++) {
+    const numA = partsA[i] || 0;
+    const numB = partsB[i] || 0;
+    if (numA > numB)
+      return 1;
+    if (numA < numB)
+      return -1;
+  }
+  return 0;
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    const response = await fetch(NPM_REGISTRY_URL, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok)
+      return null;
+    const data = await response.json();
+    return data.version || null;
+  } catch {
+    return null;
+  }
+}
+async function checkForUpdates() {
+  const state = loadUpdateState();
+  const currentVersion = getCurrentVersion();
+  const now = Date.now();
+  if (now - state.lastCheck < CHECK_INTERVAL_MS) {
+    if (state.latestVersion && compareVersions(state.latestVersion, currentVersion) > 0) {
+      if (state.dismissed === state.latestVersion) {
+        return null;
+      }
+      return {
+        hasUpdate: true,
+        currentVersion,
+        latestVersion: state.latestVersion,
+        updateCommand: `bun update -g ${PACKAGE_NAME}`
+      };
+    }
+    return null;
+  }
+  const latestVersion = await fetchLatestVersion();
+  state.lastCheck = now;
+  if (latestVersion) {
+    state.latestVersion = latestVersion;
+  }
+  saveUpdateState(state);
+  if (latestVersion && compareVersions(latestVersion, currentVersion) > 0) {
+    if (state.dismissed === latestVersion) {
+      return null;
+    }
+    return {
+      hasUpdate: true,
+      currentVersion,
+      latestVersion,
+      updateCommand: `bun update -g ${PACKAGE_NAME}`
+    };
+  }
+  return null;
+}
+async function forceCheckForUpdates() {
+  const state = loadUpdateState();
+  state.lastCheck = 0;
+  saveUpdateState(state);
+  return checkForUpdates();
+}
+
 // src/index.ts
 loadTheme();
 var getColors = () => {
@@ -24378,6 +24647,10 @@ ${colors.bold}USAGE${colors.reset}
   msh --provider <name>    Set provider (opencode-zen or openrouter)
   msh --themes             List available themes
   msh --theme <name>       Set color theme
+  msh --repo-context       Enable project context detection
+  msh --no-repo-context    Disable project context detection
+  msh --version            Show version
+  msh --check-update       Check for updates
   msh --help               Show this help
 
 ${colors.bold}EXAMPLES${colors.reset}
@@ -24390,6 +24663,9 @@ ${colors.bold}EXAMPLES${colors.reset}
   ${colors.dim}# Check what would run${colors.reset}
   msh -n "delete all log files"
   
+  ${colors.dim}# Use project context (knows your npm scripts, etc)${colors.reset}
+  msh --repo-context "run the dev server"
+  
   ${colors.dim}# Pipe to clipboard (macOS)${colors.reset}
   msh "find large files" | pbcopy
 
@@ -24593,6 +24869,27 @@ function executeCommand(command) {
     });
   });
 }
+function createSpinner(message) {
+  const frames = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+  let i = 0;
+  const isTTY = process.stderr.isTTY;
+  const interval = isTTY ? setInterval(() => {
+    process.stderr.write(`\r${colors.primary}${frames[i]}${colors.reset} ${colors.dim}${message}${colors.reset}`);
+    i = (i + 1) % frames.length;
+  }, 80) : null;
+  if (!isTTY) {
+    process.stderr.write(`${colors.dim}${message}...${colors.reset}
+`);
+  }
+  return {
+    stop: () => {
+      if (interval) {
+        clearInterval(interval);
+        process.stderr.write("\r\x1B[K");
+      }
+    }
+  };
+}
 async function translate(query, options) {
   const config2 = loadConfig();
   const apiKey = await getApiKey(config2.provider);
@@ -24604,12 +24901,18 @@ async function translate(query, options) {
   const model = ALL_MODELS.find((m) => m.id === config2.defaultModel) || (config2.provider === "opencode-zen" ? OPENCODE_ZEN_MODELS[0] : OPENROUTER_MODELS[0]);
   const history2 = loadHistory();
   const cwd = getCwd2();
+  const useRepoContext = options.repoContext ?? config2.repoContext ?? false;
+  const spinner = createSpinner(`Translating with ${model.name}`);
   try {
-    const command = await translateToCommand(apiKey, model, query, cwd, history2);
+    const command = await translateToCommand(apiKey, model, query, cwd, history2, useRepoContext);
+    spinner.stop();
     if (options.dryRun) {
       const safety = analyzeCommand(command, config2);
       console.log(`${colors.dim}Query:${colors.reset} ${query}`);
       console.log(`${colors.dim}Model:${colors.reset} ${model.name}`);
+      if (useRepoContext) {
+        console.log(`${colors.dim}Project context:${colors.reset} enabled`);
+      }
       console.log();
       console.log(`${colors.bold}Command:${colors.reset} ${command}`);
       if (safety.isDangerous) {
@@ -24634,27 +24937,58 @@ async function translate(query, options) {
       console.log(command);
     }
   } catch (error) {
+    spinner.stop();
     const message = error instanceof Error ? error.message : String(error);
     console.error(`${colors.red}Error: ${message}${colors.reset}`);
     process.exit(1);
   }
 }
+async function showUpdateNotification() {
+  try {
+    const update = await checkForUpdates();
+    if (update?.hasUpdate) {
+      console.error(`${colors.cyan}\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510${colors.reset}`);
+      console.error(`${colors.cyan}\u2502${colors.reset}  ${colors.bold}Update available!${colors.reset} ${colors.dim}${update.currentVersion}${colors.reset} \u2192 ${colors.green}${update.latestVersion}${colors.reset}          ${colors.cyan}\u2502${colors.reset}`);
+      console.error(`${colors.cyan}\u2502${colors.reset}  Run: ${colors.yellow}${update.updateCommand}${colors.reset}   ${colors.cyan}\u2502${colors.reset}`);
+      console.error(`${colors.cyan}\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518${colors.reset}`);
+      console.error();
+    }
+  } catch {}
+}
 async function main3() {
   const args = process.argv.slice(2);
+  const updatePromise = args.length > 0 && !args[0].startsWith("-i") ? showUpdateNotification() : Promise.resolve();
   if (args.length === 0 || args[0] === "-i" || args[0] === "--interactive") {
     const { default: runTui } = await init_cli().then(() => exports_cli);
     await runTui();
     return;
   }
   if (args[0] === "--help" || args[0] === "-h") {
+    await updatePromise;
     printHelp();
     return;
   }
+  if (args[0] === "--version" || args[0] === "-v") {
+    console.log(`magic-shell v${getCurrentVersion()}`);
+    return;
+  }
+  if (args[0] === "--check-update") {
+    const update = await forceCheckForUpdates();
+    if (update?.hasUpdate) {
+      console.log(`${colors.green}Update available!${colors.reset} ${update.currentVersion} \u2192 ${update.latestVersion}`);
+      console.log(`Run: ${colors.cyan}${update.updateCommand}${colors.reset}`);
+    } else {
+      console.log(`${colors.green}\u2713 You're running the latest version (${getCurrentVersion()})${colors.reset}`);
+    }
+    return;
+  }
   if (args[0] === "--setup") {
+    await updatePromise;
     await setup();
     return;
   }
   if (args[0] === "--models") {
+    await updatePromise;
     printModels();
     return;
   }
@@ -24720,8 +25054,24 @@ ${colors.bold}Available Themes${colors.reset}
     console.log(`${colors.success}\u2713 Theme set to ${themeName}${colors.reset}`);
     return;
   }
+  if (args[0] === "--repo-context") {
+    const config2 = loadConfig();
+    config2.repoContext = true;
+    saveConfig(config2);
+    console.log(`${colors.success}\u2713 Project context enabled${colors.reset}`);
+    console.log(`${colors.dim}Magic Shell will now detect package.json scripts, Makefile targets, etc.${colors.reset}`);
+    return;
+  }
+  if (args[0] === "--no-repo-context") {
+    const config2 = loadConfig();
+    config2.repoContext = false;
+    saveConfig(config2);
+    console.log(`${colors.success}\u2713 Project context disabled${colors.reset}`);
+    return;
+  }
   let execute = false;
   let dryRun = false;
+  let repoContext = undefined;
   let queryParts = [];
   for (let i = 0;i < args.length; i++) {
     const arg = args[i];
@@ -24729,6 +25079,10 @@ ${colors.bold}Available Themes${colors.reset}
       execute = true;
     } else if (arg === "-n" || arg === "--dry-run") {
       dryRun = true;
+    } else if (arg === "-r" || arg === "--repo-context") {
+      repoContext = true;
+    } else if (arg === "--no-repo-context") {
+      repoContext = false;
     } else if (!arg.startsWith("-")) {
       queryParts.push(arg);
     }
@@ -24739,7 +25093,7 @@ ${colors.bold}Available Themes${colors.reset}
     console.error(`Usage: msh "your query here"`);
     process.exit(1);
   }
-  await translate(query, { execute, dryRun });
+  await translate(query, { execute, dryRun, repoContext });
 }
 main3().catch((error) => {
   console.error(`${colors.red}Error: ${error.message}${colors.reset}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@austinthesing/magic-shell",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Natural language to terminal commands with safety features. Supports OpenCode Zen (with free models) and OpenRouter.",
   "type": "module",
   "main": "dist/index.js",