scpl-updated-mcp-server 1.0.1 → 1.0.3

package/index.js

@@ -19,7 +19,167 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 // ============================================================================
-// AUTO-SETUP: Run with --setup to install everything automatically
+// HELP
+// ============================================================================
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  console.log(`
+ScPL Updated MCP Server - Create macOS Shortcuts with AI
+
+USAGE:
+  npx scpl-updated-mcp-server [OPTIONS]
+
+OPTIONS:
+  --setup         Auto-install for Claude Code (recommended)
+  --setup-codex   Auto-install for OpenAI Codex CLI
+  --help, -h      Show this help message
+
+EXAMPLES:
+  npx scpl-updated-mcp-server --setup        # Install for Claude Code
+  npx scpl-updated-mcp-server --setup-codex  # Install for Codex
+
+After setup, restart your AI coding tool and ask:
+  "Create a shortcut that starts a timer and plays a sound"
+`);
+  process.exit(0);
+}
+
+// ============================================================================
+// CODEX SETUP: Run with --setup-codex for OpenAI Codex CLI
+// ============================================================================
+if (process.argv.includes("--setup-codex")) {
+  console.log("🚀 Setting up ScPL Shortcuts for Codex...\n");
+
+  const codexConfigPath = join(homedir(), ".codex", "config.toml");
+  const skillDir = join(homedir(), ".codex", "skills", "scpl-shortcuts");
+
+  // Step 1: Add MCP server to ~/.codex/config.toml
+  console.log("📝 Step 1: Adding MCP server to ~/.codex/config.toml...");
+  try {
+    let config = "";
+    if (existsSync(codexConfigPath)) {
+      config = readFileSync(codexConfigPath, "utf-8");
+    }
+
+    // Check if already configured
+    if (config.includes('[mcp_servers."scpl-shortcuts"]') || config.includes('[mcp_servers.scpl-shortcuts]')) {
+      console.log("   ⏭️  Already configured, skipping...\n");
+    } else {
+      const tomlBlock = `
+[mcp_servers.scpl-shortcuts]
+command = "npx"
+args = ["-y", "scpl-updated-mcp-server"]
+startup_timeout_sec = 60.0
+`;
+      writeFileSync(codexConfigPath, config + tomlBlock);
+      console.log("   ✅ MCP server added!\n");
+    }
+  } catch (error) {
+    console.error("   ❌ Failed to update config:", error.message);
+    console.log("   Add this to ~/.codex/config.toml manually:");
+    console.log(`
+[mcp_servers.scpl-shortcuts]
+command = "npx"
+args = ["-y", "scpl-updated-mcp-server"]
+startup_timeout_sec = 60.0
+`);
+  }
+
+  // Step 2: Install skill to ~/.codex/skills/scpl-shortcuts/
+  console.log("📁 Step 2: Installing skill to ~/.codex/skills/scpl-shortcuts/...");
+  try {
+    mkdirSync(skillDir, { recursive: true });
+
+    const skillContent = `---
+name: scpl-shortcuts
+description: Create macOS Shortcuts using natural language. Use when users want to create, generate, or build Apple Shortcuts. Converts requests to ScPL code and generates .shortcut files.
+metadata:
+  short-description: Create macOS Shortcuts with AI
+---
+
+# ScPL Shortcuts Skill
+
+Create macOS Shortcuts using natural language with 493 available actions.
+
+## MCP Tools Available
+
+You have access to the \`scpl-shortcuts\` MCP server with these tools:
+
+| Tool | Description |
+|------|-------------|
+| \`create_shortcut\` | Generate a .shortcut file from ScPL code |
+| \`validate_scpl\` | Check if ScPL code is valid before creating |
+| \`list_actions\` | Search available actions by category or keyword |
+
+## ScPL Syntax
+
+ScPL is line-based. Each line is an action. Parameters use \`key=value\` or \`key="value"\`.
+
+\`\`\`scpl
+# Comments start with #
+Text "Hello World"
+ShowResult
+
+# Variables
+Text "some value"
+SetVariable v:myVar
+ShowResult v:myVar
+
+# AI actions
+AskLLM model="Apple Intelligence" prompt="Summarize this"
+AskChatGPT prompt="Explain this"
+\`\`\`
+
+## Popular Actions by Category
+
+**AI**: AskLLM, AskChatGPT, AskClaude
+**Clock**: StartStopwatch, StopStopwatch, CreateAlarm
+**Voice Memos**: CreateRecording, PlayRecording
+**System**: SetDarkMode, TakeScreenshot, LockScreen
+**Files**: GetFile, SaveFile, RenameFile, RevealInFinder
+**Scripting**: RunShellScript, RunAppleScript, RunJavaScriptForAutomation
+**Clipboard**: GetClipboard, SetClipboard
+
+## Workflow
+
+1. User describes what shortcut they want
+2. Use \`list_actions\` if you need to find specific actions
+3. Write ScPL code for the shortcut
+4. Use \`validate_scpl\` to check syntax
+5. Use \`create_shortcut\` to generate the .shortcut file
+6. Tell user to install via Shortcut Source Helper from RoutineHub
+
+## Example: Timer with Notification
+
+\`\`\`scpl
+# Start a 25-minute Pomodoro timer
+StartTimer minutes=25
+ShowAlert title="Timer Started" message="Focus for 25 minutes!"
+\`\`\`
+
+## Example: Clipboard AI Enhancement
+
+\`\`\`scpl
+GetClipboard
+SetVariable v:text
+AskChatGPT prompt="Improve this text: \\(v:text)"
+SetClipboard
+ShowAlert title="Done" message="Improved text copied!"
+\`\`\`
+`;
+    writeFileSync(join(skillDir, "SKILL.md"), skillContent);
+    console.log("   ✅ Skill installed!\n");
+  } catch (error) {
+    console.error("   ❌ Failed to install skill:", error.message, "\n");
+  }
+
+  console.log("🎉 Setup complete! Restart Codex to use the shortcuts tools.\n");
+  console.log("Usage: Just ask Codex to create a shortcut!");
+  console.log('  Example: "Create a shortcut that starts a timer and plays a sound"\n');
+  process.exit(0);
+}
+
+// ============================================================================
+// CLAUDE CODE SETUP: Run with --setup to install everything automatically
 // ============================================================================
 if (process.argv.includes("--setup")) {
   console.log("🚀 Setting up ScPL Shortcuts for Claude Code...\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scpl-updated-mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "AI-powered Apple Shortcuts creation with Claude Code! Generate macOS shortcuts using natural language. 493 actions available. MCP server for text-based shortcut programming. Vibe code your automation workflows.",
   "type": "module",
   "main": "index.js",