@austinthesing/magic-shell 0.1.3 → 0.2.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Magic Shell Contributors
+Copyright (c) 2026 austin-thesing and Magic Shell Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

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
@@ -83,7 +67,7 @@ export OPENCODE_ZEN_API_KEY="your-key-here"
 
 ## Usage
 
-Magic Shell can be invoked using `magic-shell`, `msh`, or `ms`.
+Magic Shell can be invoked using `magic-shell`, `msh`, or `ms`. For TUI mode directly, use `mshell`.
 
 ### Basic Commands
 
@@ -100,8 +84,8 @@ msh -n "delete all node_modules folders"
 
 # Launch interactive TUI mode
 msh -i
-# or just
-msh
+# or directly with
+mshell
 ```
 
 ### Command Reference
@@ -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
@@ -147,7 +135,7 @@ msh "compress this folder to a zip file" | pbcopy
 
 ## Interactive TUI Mode
 
-Launch with `msh` or `msh -i` for a full interactive experience.
+Launch with `mshell` or `msh -i` for a full interactive experience.
 
 ### Keyboard Shortcuts
 
@@ -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",