star-sdk-cli 0.1.2 → 0.1.4

package/dist/cli.mjs

@@ -8,7 +8,7 @@ import * as os from "os";
 // src/skills.ts
 var SKILL_CONTENT = `---
 name: star-sdk
-description: Star SDK for browser game development. Use when building games, adding audio/sound effects, canvas rendering, leaderboards, or multiplayer. Covers Star.game(), Star.audio, Star.leaderboard, and Star.multiplayer APIs.
+description: Use when you need a game that works on mobile without audio issues, has leaderboards without building a backend, or needs multiplayer without WebSocket complexity. Handles iOS Safari audio unlocking, DPR scaling, and coordinate conversion automatically.
 ---
 
 # Star SDK
@@ -72,9 +72,14 @@ function gameOver(finalScore) {
 }
 \`\`\`
 
-### Mobile Audio (IMPORTANT)
+### Audio (It Just Works)
 
-Audio on mobile requires user interaction first. Star.audio handles unlocking automatically - just make sure the first \`play()\` call happens after a user interaction (click/tap).
+Star.audio handles mobile audio unlocking automatically. Just call \`play()\` - no special handling needed.
+
+\`\`\`javascript
+Star.audio.preload({ coin: 'coin', jump: 'jump' });
+Star.audio.play('coin');  // Works on mobile, desktop, everywhere
+\`\`\`
 
 ### Coordinate Handling
 
@@ -1655,14 +1660,22 @@ function showHelp() {
 ${colors.bright}Star SDK CLI${colors.reset} v${VERSION}
 
 ${colors.dim}Commands:${colors.reset}
-  ${colors.cyan}init <name>${colors.reset}     Register a new game
-  ${colors.cyan}install${colors.reset}         Install Star SDK skill for Claude Code
-  ${colors.cyan}docs [topic]${colors.reset}    Print API documentation (topics: audio, canvas, leaderboard, multiplayer)
-  ${colors.cyan}whoami${colors.reset}          Show current configuration
+  ${colors.cyan}init <name>${colors.reset}        Register a new game
+  ${colors.cyan}install [agent]${colors.reset}    Install Star SDK docs for AI coding agents
+  ${colors.cyan}docs [topic]${colors.reset}       Print API documentation (default: all docs)
+  ${colors.cyan}whoami${colors.reset}             Show current configuration
+
+${colors.dim}Supported agents:${colors.reset}
+  ${colors.cyan}claude${colors.reset}   ${colors.dim}(default)${colors.reset}  Claude Code   \u2192 ~/.claude/skills/star-sdk/
+  ${colors.cyan}codex${colors.reset}              OpenAI Codex  \u2192 ./AGENTS.md
+  ${colors.cyan}cursor${colors.reset}             Cursor        \u2192 .cursor/rules/star-sdk.mdc
+  ${colors.cyan}windsurf${colors.reset}           Windsurf      \u2192 .windsurf/rules/star-sdk.md
+  ${colors.cyan}aider${colors.reset}              Aider         \u2192 ./CONVENTIONS.md
 
 ${colors.dim}Options:${colors.reset}
   --email <email>   Email for higher rate limits (optional)
-  --project         Install skill to project instead of personal (~/.claude)
+  --global          Install to global location (codex: ~/.codex/)
+  --project         Install to project directory
   --help            Show this help message
   --version         Show version
 
@@ -1670,14 +1683,19 @@ ${colors.dim}Examples:${colors.reset}
   ${colors.dim}# Register a new game${colors.reset}
   npx star-sdk init "My Awesome Game"
 
-  ${colors.dim}# Install SDK skill for Claude Code${colors.reset}
-  npx star-sdk install
+  ${colors.dim}# Install for different AI agents${colors.reset}
+  npx star-sdk install           ${colors.dim}# Claude Code (default)${colors.reset}
+  npx star-sdk install codex     ${colors.dim}# OpenAI Codex${colors.reset}
+  npx star-sdk install cursor    ${colors.dim}# Cursor${colors.reset}
+  npx star-sdk install windsurf  ${colors.dim}# Windsurf${colors.reset}
+  npx star-sdk install aider     ${colors.dim}# Aider${colors.reset}
 
-  ${colors.dim}# Print API documentation${colors.reset}
-  npx star-sdk docs
-  npx star-sdk docs audio
+  ${colors.dim}# Print API docs (works with any LLM)${colors.reset}
+  npx star-sdk docs              ${colors.dim}# All docs${colors.reset}
+  npx star-sdk docs audio        ${colors.dim}# Just audio API${colors.reset}
+  npx star-sdk docs skill        ${colors.dim}# Just main skill file${colors.reset}
 
-${colors.dim}Learn more:${colors.reset} https://buildwithstar.com/docs/sdk
+${colors.dim}Learn more:${colors.reset} https://buildwithstar.com/docs
 `);
 }
 function showVersion() {
@@ -1756,13 +1774,11 @@ async function initCommand(name, email) {
     log(`  ${colors.cyan}import Star from 'star-sdk';${colors.reset}`);
     log(`  ${colors.cyan}Star.leaderboard.submit(1500);${colors.reset}`);
     log("");
-    if (process.env.CLAUDE_SESSION_ID) {
-      info(`Claude Code detected! Run ${colors.cyan}npx star-sdk install${colors.reset} to enable auto-discovery.`);
-      log("");
-    }
+    log(`${colors.dim}Using an AI coding agent?${colors.reset}`);
+    log(`  ${colors.cyan}npx star-sdk install${colors.reset}        ${colors.dim}Claude Code, Codex, Cursor, Windsurf, Aider${colors.reset}`);
+    log("");
     log(`${colors.dim}Documentation:${colors.reset}`);
-    log(`  ${colors.dim}Full docs:${colors.reset}  ${colors.cyan}https://buildwithstar.com/docs/sdk${colors.reset}`);
-    log(`  ${colors.dim}CLI docs:${colors.reset}   ${colors.cyan}npx star-sdk docs${colors.reset}`);
+    log(`  ${colors.cyan}https://buildwithstar.com/docs${colors.reset}`);
     log("");
   } catch (err) {
     if (err.code === "ECONNREFUSED" || err.code === "ENOTFOUND") {
@@ -1794,47 +1810,183 @@ function whoamiCommand() {
   }
   log("");
 }
-function installCommand(scope = "personal") {
-  const skillDir = scope === "personal" ? path.join(os.homedir(), ".claude", "skills", "star-sdk") : path.join(process.cwd(), ".claude", "skills", "star-sdk");
+function transformForStdout(content) {
+  return content.replace(/\[(\w+)\.md\]\(\.\/\1\.md\)/g, "$1 (`npx star-sdk docs $1`)").replace(/see (\w+)\.md/g, "run `npx star-sdk docs $1`").replace(
+    /For detailed API documentation, see the linked files above\./,
+    "For detailed API docs: `npx star-sdk docs <topic>` where topic is audio, canvas, leaderboard, or multiplayer."
+  );
+}
+function getAllDocsContent() {
+  return `${SKILL_CONTENT}
+
+---
+
+# Audio API
+
+${AUDIO_DOCS}
+
+---
+
+# Canvas API
+
+${CANVAS_DOCS}
+
+---
+
+# Leaderboard API
+
+${LEADERBOARD_DOCS}
+
+---
+
+# Multiplayer API
+
+${MULTIPLAYER_DOCS}`;
+}
+function installClaudeCode(scope) {
+  const skillDir = scope === "global" ? path.join(os.homedir(), ".claude", "skills", "star-sdk") : path.join(process.cwd(), ".claude", "skills", "star-sdk");
+  fs.mkdirSync(skillDir, { recursive: true });
+  fs.writeFileSync(path.join(skillDir, "SKILL.md"), SKILL_CONTENT);
+  fs.writeFileSync(path.join(skillDir, "audio.md"), AUDIO_DOCS);
+  fs.writeFileSync(path.join(skillDir, "canvas.md"), CANVAS_DOCS);
+  fs.writeFileSync(path.join(skillDir, "leaderboard.md"), LEADERBOARD_DOCS);
+  fs.writeFileSync(path.join(skillDir, "multiplayer.md"), MULTIPLAYER_DOCS);
+  log("");
+  success(`Star SDK skill installed to ${skillDir}`);
+  log("");
+  log(`${colors.dim}Claude Code will now auto-discover the Star SDK when you work on games.${colors.reset}`);
+  log("");
+  log(`${colors.dim}Installed files:${colors.reset}`);
+  log(`  SKILL.md        ${colors.dim}Main skill entry point${colors.reset}`);
+  log(`  audio.md        ${colors.dim}Star.audio API docs${colors.reset}`);
+  log(`  canvas.md       ${colors.dim}Star.game() API docs${colors.reset}`);
+  log(`  leaderboard.md  ${colors.dim}Star.leaderboard API docs${colors.reset}`);
+  log(`  multiplayer.md  ${colors.dim}Star.multiplayer API docs${colors.reset}`);
+  log("");
+}
+function installCodex(scope) {
+  const content = `# Star SDK - Browser Game Development
+
+${getAllDocsContent()}`;
+  const filePath = scope === "global" ? path.join(os.homedir(), ".codex", "AGENTS.md") : path.join(process.cwd(), "AGENTS.md");
+  if (scope === "global") {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  }
+  if (fs.existsSync(filePath)) {
+    const existing = fs.readFileSync(filePath, "utf-8");
+    if (existing.includes("Star SDK")) {
+      info(`Star SDK already present in ${filePath}`);
+      return;
+    }
+    fs.writeFileSync(filePath, existing + "\n\n" + content);
+    success(`Star SDK appended to ${filePath}`);
+  } else {
+    fs.writeFileSync(filePath, content);
+    success(`Star SDK installed to ${filePath}`);
+  }
+  log("");
+  log(`${colors.dim}Codex will now have access to Star SDK documentation.${colors.reset}`);
+  log("");
+}
+function installCursor() {
+  const rulesDir = path.join(process.cwd(), ".cursor", "rules");
+  const filePath = path.join(rulesDir, "star-sdk.mdc");
+  const content = `---
+description: Star SDK for browser game development with audio, canvas, leaderboards, and multiplayer
+globs: ["**/*.js", "**/*.ts", "**/*.jsx", "**/*.tsx", "**/*.html"]
+alwaysApply: false
+---
+
+${getAllDocsContent()}`;
+  fs.mkdirSync(rulesDir, { recursive: true });
+  fs.writeFileSync(filePath, content);
+  log("");
+  success(`Star SDK installed to ${filePath}`);
+  log("");
+  log(`${colors.dim}Cursor will now have access to Star SDK documentation.${colors.reset}`);
+  log(`${colors.dim}Use @star-sdk to reference it in Cursor chat.${colors.reset}`);
+  log("");
+}
+function installWindsurf() {
+  const rulesDir = path.join(process.cwd(), ".windsurf", "rules");
+  const filePath = path.join(rulesDir, "star-sdk.md");
+  const content = `# Star SDK - Browser Game Development
+
+${getAllDocsContent()}`;
+  fs.mkdirSync(rulesDir, { recursive: true });
+  fs.writeFileSync(filePath, content);
+  log("");
+  success(`Star SDK installed to ${filePath}`);
+  log("");
+  log(`${colors.dim}Windsurf will now have access to Star SDK documentation.${colors.reset}`);
+  log("");
+}
+function installAider() {
+  const filePath = path.join(process.cwd(), "CONVENTIONS.md");
+  const content = `# Star SDK - Browser Game Development
+
+${getAllDocsContent()}`;
+  if (fs.existsSync(filePath)) {
+    const existing = fs.readFileSync(filePath, "utf-8");
+    if (existing.includes("Star SDK")) {
+      info(`Star SDK already present in ${filePath}`);
+      return;
+    }
+    fs.writeFileSync(filePath, existing + "\n\n" + content);
+    success(`Star SDK appended to ${filePath}`);
+  } else {
+    fs.writeFileSync(filePath, content);
+    success(`Star SDK installed to ${filePath}`);
+  }
+  log("");
+  log(`${colors.dim}Add to aider with: aider --read CONVENTIONS.md${colors.reset}`);
+  log("");
+}
+function installCommand(agent = "claude", scope = "global") {
   try {
-    fs.mkdirSync(skillDir, { recursive: true });
-    fs.writeFileSync(path.join(skillDir, "SKILL.md"), SKILL_CONTENT);
-    fs.writeFileSync(path.join(skillDir, "audio.md"), AUDIO_DOCS);
-    fs.writeFileSync(path.join(skillDir, "canvas.md"), CANVAS_DOCS);
-    fs.writeFileSync(path.join(skillDir, "leaderboard.md"), LEADERBOARD_DOCS);
-    fs.writeFileSync(path.join(skillDir, "multiplayer.md"), MULTIPLAYER_DOCS);
-    log("");
-    success(`Star SDK skill installed to ${skillDir}`);
-    log("");
-    log(`${colors.dim}Claude Code will now auto-discover the Star SDK when you work on games.${colors.reset}`);
-    log("");
-    log(`${colors.dim}Installed files:${colors.reset}`);
-    log(`  SKILL.md        ${colors.dim}Main skill entry point${colors.reset}`);
-    log(`  audio.md        ${colors.dim}Star.audio API docs${colors.reset}`);
-    log(`  canvas.md       ${colors.dim}Star.game() API docs${colors.reset}`);
-    log(`  leaderboard.md  ${colors.dim}Star.leaderboard API docs${colors.reset}`);
-    log(`  multiplayer.md  ${colors.dim}Star.multiplayer API docs${colors.reset}`);
-    log("");
+    switch (agent) {
+      case "claude":
+        installClaudeCode(scope);
+        break;
+      case "codex":
+        installCodex(scope);
+        break;
+      case "cursor":
+        installCursor();
+        break;
+      case "windsurf":
+        installWindsurf();
+        break;
+      case "aider":
+        installAider();
+        break;
+      default:
+        error(`Unknown agent: ${agent}`);
+        log("");
+        log("Supported agents: claude, codex, cursor, windsurf, aider");
+        process.exit(1);
+    }
   } catch (err) {
-    error(`Failed to install skill: ${err.message}`);
+    error(`Failed to install: ${err.message}`);
     process.exit(1);
   }
 }
 function docsCommand(topic) {
   const docs = {
+    skill: SKILL_CONTENT,
     audio: AUDIO_DOCS,
     canvas: CANVAS_DOCS,
     leaderboard: LEADERBOARD_DOCS,
     multiplayer: MULTIPLAYER_DOCS
   };
   if (!topic) {
-    console.log(SKILL_CONTENT);
+    console.log(transformForStdout(SKILL_CONTENT));
   } else if (docs[topic]) {
     console.log(docs[topic]);
   } else {
     error(`Unknown topic: ${topic}`);
     log("");
-    log("Available topics: audio, canvas, leaderboard, multiplayer");
+    log("Available topics: skill, audio, canvas, leaderboard, multiplayer");
     process.exit(1);
   }
 }
@@ -1877,9 +2029,12 @@ async function main() {
     case "init":
       await initCommand(positional[0], email);
       break;
-    case "install":
-      installCommand(flags.project ? "project" : "personal");
+    case "install": {
+      const agent = positional[0] || "claude";
+      const scope = flags.project ? "project" : "global";
+      installCommand(agent, scope);
       break;
+    }
     case "docs":
     case "skill":
     case "prompt":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "star-sdk-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CLI tool for Star SDK - register games and manage leaderboards",
   "type": "module",
   "bin": {