scpl-updated-mcp-server 1.0.2 → 1.0.4

package/index.js

@@ -29,13 +29,19 @@ 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
+  --setup                    Auto-install for Claude Code
+  --setup-codex              Auto-install for OpenAI Codex CLI (~/.codex)
+  --setup-codex=<dir>        Auto-install for Codex forks with custom directory
+  --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
+  npx scpl-updated-mcp-server --setup
+  npx scpl-updated-mcp-server --setup-codex
+  npx scpl-updated-mcp-server --setup-codex=~/.code
+  npx scpl-updated-mcp-server --setup-codex=/path/to/code_config
+
+For Codex forks like just-every/code that use CODE_HOME or CODEX_HOME:
+  npx scpl-updated-mcp-server --setup-codex=$CODE_HOME
 
 After setup, restart your AI coding tool and ask:
   "Create a shortcut that starts a timer and plays a sound"
@@ -44,16 +50,29 @@ After setup, restart your AI coding tool and ask:
 }
 
 // ============================================================================
-// CODEX SETUP: Run with --setup-codex for OpenAI Codex CLI
+// CODEX SETUP: Run with --setup-codex or --setup-codex=<dir>
 // ============================================================================
-if (process.argv.includes("--setup-codex")) {
-  console.log("🚀 Setting up ScPL Shortcuts for Codex...\n");
+const codexArg = process.argv.find(arg => arg.startsWith("--setup-codex"));
+if (codexArg) {
+  // Check for custom directory: --setup-codex=/path/to/dir or --setup-codex=~/custom
+  let codexDir = join(homedir(), ".codex"); // default
+
+  if (codexArg.includes("=")) {
+    let customDir = codexArg.split("=")[1];
+    // Expand ~ to home directory
+    if (customDir.startsWith("~")) {
+      customDir = customDir.replace("~", homedir());
+    }
+    codexDir = customDir;
+  }
 
-  const codexConfigPath = join(homedir(), ".codex", "config.toml");
-  const agentsPath = join(homedir(), ".codex", "AGENTS.md");
+  console.log(`🚀 Setting up ScPL Shortcuts for Codex at ${codexDir}...\n`);
 
-  // Step 1: Add MCP server to ~/.codex/config.toml
-  console.log("📝 Step 1: Adding MCP server to ~/.codex/config.toml...");
+  const codexConfigPath = join(codexDir, "config.toml");
+  const skillDir = join(codexDir, "skills", "scpl-shortcuts");
+
+  // Step 1: Add MCP server to config.toml
+  console.log(`📝 Step 1: Adding MCP server to ${codexConfigPath}...`);
   try {
     let config = "";
     if (existsSync(codexConfigPath)) {
@@ -84,42 +103,92 @@ startup_timeout_sec = 60.0
 `);
   }
 
-  // Step 2: Add instructions to AGENTS.md
-  console.log("📁 Step 2: Adding skill instructions to AGENTS.md...");
+  // Step 2: Install skill
+  console.log(`📁 Step 2: Installing skill to ${skillDir}...`);
   try {
-    let agents = "";
-    if (existsSync(agentsPath)) {
-      agents = readFileSync(agentsPath, "utf-8");
-    }
+    mkdirSync(skillDir, { recursive: true });
 
-    if (agents.includes("## ScPL Shortcuts")) {
-      console.log("   ⏭️  Already in AGENTS.md, skipping...\n");
-    } else {
-      const agentBlock = `
+    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
+# ScPL Shortcuts Skill
 
-You have access to the ScPL MCP server with 493 actions for creating macOS Shortcuts.
+Create macOS Shortcuts using natural language with 493 available actions.
+
+## MCP Tools Available
 
-**Tools available:**
-- \`create_shortcut\` - Generate a .shortcut file from ScPL code
-- \`validate_scpl\` - Check if ScPL code is valid
-- \`list_actions\` - Search available actions
+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 syntax example:**
 \`\`\`scpl
-Text "Hello"
-AskLLM model="Apple Intelligence" prompt="Make it fun"
+# 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!"
 \`\`\`
 
-When user asks to create a shortcut, write ScPL code, validate it, then create the file.
+## 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(agentsPath, agents + agentBlock);
-      console.log("   ✅ Instructions added!\n");
-    }
+    writeFileSync(join(skillDir, "SKILL.md"), skillContent);
+    console.log("   ✅ Skill installed!\n");
   } catch (error) {
-    console.error("   ❌ Failed to update AGENTS.md:", error.message, "\n");
+    console.error("   ❌ Failed to install skill:", error.message, "\n");
   }
 
   console.log("🎉 Setup complete! Restart Codex to use the shortcuts tools.\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scpl-updated-mcp-server",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "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",