ropilot 0.1.8 → 0.1.10

package/bin/ropilot.js

@@ -4,8 +4,9 @@
  * Ropilot CLI
  *
  * Commands:
- *   ropilot init [key]  - Set up Ropilot in current project (downloads prompts, creates configs)
- *   ropilot             - Run as stdio MCP server (proxies to edge)
+ *   ropilot             - Show help
+ *   ropilot init [key]  - Set up Ropilot in current project
+ *   ropilot serve       - Run as stdio MCP server (used by Claude Code)
  *   ropilot config      - Show current configuration
  *   ropilot update      - Update prompts and configs to latest version
  */
@@ -18,12 +19,55 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const libDir = join(__dirname, '..', 'lib');
 
+// Get version from package.json
+function getVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+    return pkg.version;
+  } catch {
+    return 'unknown';
+  }
+}
+
+function showHelp() {
+  const version = getVersion();
+  console.log('');
+  console.log(`  Ropilot v${version} - AI-powered Roblox development`);
+  console.log('');
+  console.log('  Usage:');
+  console.log('    ropilot init [key]   Set up Ropilot in current project');
+  console.log('    ropilot config       Show current configuration');
+  console.log('    ropilot update       Update prompts to latest version');
+  console.log('    ropilot serve        Run MCP server (used by Claude Code)');
+  console.log('');
+  console.log('  Getting started:');
+  console.log('    1. Get an API key at https://ropilot.ai');
+  console.log('    2. Run: ropilot init');
+  console.log('    3. Restart Roblox Studio and enter your API key in plugin settings');
+  console.log('    4. Start Claude Code in your project directory');
+  console.log('');
+}
+
 // Parse command line args
 const args = process.argv.slice(2);
-const command = args[0] || 'serve';
+const command = args[0] || 'help';
 
 async function main() {
   switch (command) {
+    case 'help':
+    case '--help':
+    case '-h': {
+      showHelp();
+      break;
+    }
+
+    case 'version':
+    case '--version':
+    case '-v': {
+      console.log(getVersion());
+      break;
+    }
+
     case 'init': {
       const { init } = await import(join(libDir, 'setup.js'));
       const apiKey = args[1] || null;
@@ -43,24 +87,17 @@ async function main() {
       break;
     }
 
-    case 'serve':
-    default: {
-      // If first arg looks like a command but isn't recognized, show help
-      if (command && !command.startsWith('-') && !['serve', 'init', 'update', 'config'].includes(command)) {
-        console.error(`Unknown command: ${command}`);
-        console.error('');
-        console.error('Usage:');
-        console.error('  ropilot init [key]  - Set up Ropilot in current project');
-        console.error('  ropilot             - Run as stdio MCP server');
-        console.error('  ropilot config      - Show current configuration');
-        console.error('  ropilot update      - Update prompts to latest version');
-        process.exit(1);
-      }
-
+    case 'serve': {
       const { serve } = await import(join(libDir, 'proxy.js'));
       await serve();
       break;
     }
+
+    default: {
+      console.error(`Unknown command: ${command}`);
+      showHelp();
+      process.exit(1);
+    }
   }
 }
 

package/lib/setup.js

@@ -221,15 +221,34 @@ async function installPlugin() {
   }
 }
 
+/**
+ * Install ropilot globally so it's available as a command
+ */
+function installGlobally() {
+  console.log('Installing ropilot globally...');
+  try {
+    execSync('npm install -g ropilot', { encoding: 'utf-8', stdio: 'inherit' });
+    console.log('  Installed successfully!');
+    return true;
+  } catch (err) {
+    console.error('  Failed to install globally. You may need to run with sudo or fix npm permissions.');
+    console.log('  Falling back to npx...');
+    return false;
+  }
+}
+
 /**
  * Create .mcp.json for Claude Code compatibility
  */
-function createMcpConfig() {
+function createMcpConfig(useNpx = false) {
   const mcpConfig = {
     mcpServers: {
-      ropilot: {
+      ropilot: useNpx ? {
         command: "npx",
-        args: ["ropilot"]
+        args: ["ropilot", "serve"]
+      } : {
+        command: "ropilot",
+        args: ["serve"]
       }
     }
   };
@@ -427,8 +446,12 @@ export async function init(providedApiKey = null) {
     console.log('');
   }
 
-  // Install Studio plugin
+  // Install ropilot globally
   console.log('');
+  const globalInstallOk = installGlobally();
+  console.log('');
+
+  // Install Studio plugin
   await installPlugin();
   console.log('');
 
@@ -439,7 +462,7 @@ export async function init(providedApiKey = null) {
   // Set up project files
   console.log('Setting up project files...');
   setupProjectPrompts(pkg);
-  createMcpConfig();
+  createMcpConfig(!globalInstallOk);
   console.log('');
 
   // Done!

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ropilot",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "AI-powered Roblox development assistant - MCP CLI",
   "author": "whut",
   "license": "MIT",