aether-init 0.4.0

package/index.mjs

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+
+/**
+ * aether-init: One-command installer for Aether
+ * 
+ * Usage: npx aether-init
+ * 
+ * Does:
+ * 1. Downloads Aether Bridge binary for current OS/arch
+ * 2. Installs Unity SDK via UPM (if in a Unity project)
+ * 3. Writes .cursor/mcp.json so Cursor connects automatically
+ */
+
+import { createWriteStream, existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from "fs";
+import { homedir, platform, arch } from "os";
+import { join, dirname } from "path";
+import { execSync } from "child_process";
+import { get as httpsGet } from "https";
+import { get as httpGet } from "http";
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+const DOWNLOADS_BASE = "https://downloads.getaether.dev";
+const UPM_GIT_URL = "https://github.com/finexma-dev/aether.git?path=unity-sdk/Aether";
+
+// =============================================================================
+// Utilities
+// =============================================================================
+
+function log(msg) {
+  console.log(`\x1b[36m[aether]\x1b[0m ${msg}`);
+}
+
+function success(msg) {
+  console.log(`\x1b[32m[aether]\x1b[0m ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`\x1b[33m[aether]\x1b[0m ${msg}`);
+}
+
+function error(msg) {
+  console.error(`\x1b[31m[aether]\x1b[0m ${msg}`);
+}
+
+function detectPlatform() {
+  const os = platform();
+  const cpu = arch();
+
+  if (os === "win32") return { os: "windows", arch: "x64", ext: ".exe" };
+  if (os === "darwin") {
+    // arm64 = Apple Silicon, x64 = Intel
+    return { os: "darwin", arch: cpu === "arm64" ? "arm64" : "x64", ext: "" };
+  }
+  if (os === "linux") return { os: "linux", arch: "x64", ext: "" };
+
+  throw new Error(`Unsupported platform: ${os}/${cpu}`);
+}
+
+function getBinaryName(plat) {
+  return `aether-bridge-${plat.os}-${plat.arch}${plat.ext}`;
+}
+
+function getInstallDir() {
+  return join(homedir(), ".aether", "bin");
+}
+
+function fetchJson(url) {
+  return new Promise((resolve, reject) => {
+    const getter = url.startsWith("https") ? httpsGet : httpGet;
+    getter(url, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return fetchJson(res.headers.location).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+      }
+      let data = "";
+      res.on("data", (chunk) => (data += chunk));
+      res.on("end", () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch (e) {
+          reject(new Error(`Invalid JSON from ${url}`));
+        }
+      });
+      res.on("error", reject);
+    }).on("error", reject);
+  });
+}
+
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const getter = url.startsWith("https") ? httpsGet : httpGet;
+    getter(url, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return downloadFile(res.headers.location, dest).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+      }
+      const file = createWriteStream(dest);
+      res.pipe(file);
+      file.on("finish", () => {
+        file.close(resolve);
+      });
+      file.on("error", (e) => {
+        file.close();
+        reject(e);
+      });
+    }).on("error", reject);
+  });
+}
+
+// =============================================================================
+// Steps
+// =============================================================================
+
+async function downloadBridge() {
+  const plat = detectPlatform();
+  const binaryName = getBinaryName(plat);
+  const installDir = getInstallDir();
+  const destPath = join(installDir, binaryName);
+
+  log(`Detected platform: ${plat.os}/${plat.arch}`);
+
+  // Create install directory
+  mkdirSync(installDir, { recursive: true });
+
+  // Fetch latest.json to get download URL
+  log("Fetching latest release info...");
+  let downloadUrl;
+  try {
+    const latest = await fetchJson(`${DOWNLOADS_BASE}/releases/latest.json`);
+    const keyMap = {
+      "windows-x64": "windowsX64",
+      "darwin-arm64": "macosArm64",
+      "darwin-x64": "macosX64",
+      "linux-x64": "linuxX64",
+    };
+    const key = keyMap[`${plat.os}-${plat.arch}`];
+    downloadUrl = latest?.files?.bridge?.[key]?.url;
+
+    if (!downloadUrl) {
+      // Fallback to direct URL pattern
+      const version = latest?.version || "latest";
+      downloadUrl = `${DOWNLOADS_BASE}/releases/v${version}/${binaryName}`;
+    }
+  } catch {
+    // Fallback: try direct download
+    downloadUrl = `${DOWNLOADS_BASE}/releases/latest/${binaryName}`;
+  }
+
+  log(`Downloading ${binaryName}...`);
+  await downloadFile(downloadUrl, destPath);
+
+  // Make executable on Unix
+  if (plat.os !== "windows") {
+    chmodSync(destPath, 0o755);
+  }
+
+  // Remove macOS quarantine
+  if (plat.os === "darwin") {
+    try {
+      execSync(`xattr -d com.apple.quarantine "${destPath}" 2>/dev/null`, { stdio: "ignore" });
+    } catch {
+      // Quarantine may not be present, that's fine
+    }
+  }
+
+  success(`Bridge installed: ${destPath}`);
+  return destPath;
+}
+
+function findUnityProject() {
+  // Look for Assets/ directory in cwd or parent directories
+  let dir = process.cwd();
+  for (let i = 0; i < 5; i++) {
+    if (existsSync(join(dir, "Assets")) && existsSync(join(dir, "ProjectSettings"))) {
+      return dir;
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+function installUnitySdk(projectDir) {
+  const manifestPath = join(projectDir, "Packages", "manifest.json");
+
+  if (!existsSync(manifestPath)) {
+    warn("No Packages/manifest.json found. Skipping UPM install.");
+    warn(`Manually add the SDK: Window > Package Manager > + > Add from git URL:`);
+    warn(`  ${UPM_GIT_URL}`);
+    return false;
+  }
+
+  try {
+    const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+
+    if (manifest.dependencies && manifest.dependencies["dev.getaether.sdk"]) {
+      log("Aether SDK already in manifest.json");
+      return true;
+    }
+
+    if (!manifest.dependencies) manifest.dependencies = {};
+    manifest.dependencies["dev.getaether.sdk"] = UPM_GIT_URL;
+
+    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n");
+    success("Aether SDK added to Packages/manifest.json");
+    log("Unity will download the package on next Editor focus.");
+    return true;
+  } catch (e) {
+    warn(`Failed to update manifest.json: ${e.message}`);
+    warn(`Manually add the SDK: ${UPM_GIT_URL}`);
+    return false;
+  }
+}
+
+function writeCursorConfig(bridgePath) {
+  const cwd = process.cwd();
+  const cursorDir = join(cwd, ".cursor");
+  const mcpJsonPath = join(cursorDir, "mcp.json");
+
+  // Normalize path to forward slashes (Cursor expects this on all platforms)
+  const normalizedPath = bridgePath.replace(/\\/g, "/");
+
+  mkdirSync(cursorDir, { recursive: true });
+
+  let config;
+  if (existsSync(mcpJsonPath)) {
+    try {
+      config = JSON.parse(readFileSync(mcpJsonPath, "utf-8"));
+    } catch {
+      config = {};
+    }
+  } else {
+    config = {};
+  }
+
+  if (!config.mcpServers) config.mcpServers = {};
+  config.mcpServers.aether = {
+    command: normalizedPath,
+    args: ["--stdio"],
+  };
+
+  writeFileSync(mcpJsonPath, JSON.stringify(config, null, 2) + "\n");
+  success(`Cursor MCP configured: ${mcpJsonPath}`);
+}
+
+// Vision is handled automatically via Aether's cloud proxy for Pro/Studio users.
+// No local setup needed. Users who want local privacy can set up Ollama manually.
+// See: https://getaether.dev/docs/tools#vision
+
+// =============================================================================
+// Main
+// =============================================================================
+
+async function main() {
+  console.log();
+  console.log("  \x1b[1m\x1b[36mAether\x1b[0m - AI co-debugging for Unity");
+  console.log("  \x1b[2mStop narrating. Your AI can see the game.\x1b[0m");
+  console.log();
+
+  try {
+    // Step 1: Download bridge binary
+    log("Step 1/3: Downloading Aether Bridge...");
+    const bridgePath = await downloadBridge();
+
+    // Step 2: Install Unity SDK (if in a Unity project)
+    log("Step 2/3: Installing Unity SDK...");
+    const unityProject = findUnityProject();
+    if (unityProject) {
+      log(`Unity project found: ${unityProject}`);
+      installUnitySdk(unityProject);
+    } else {
+      warn("Not in a Unity project directory. Skipping SDK install.");
+      warn("Run this from your Unity project root, or install manually:");
+      warn(`  UPM: ${UPM_GIT_URL}`);
+    }
+
+    // Step 3: Write Cursor MCP config
+    log("Step 3/3: Configuring Cursor IDE...");
+    writeCursorConfig(bridgePath);
+
+    // Done!
+    console.log();
+    success("Aether is ready!");
+    console.log();
+    console.log("  Next steps:");
+    console.log("  \x1b[1m1.\x1b[0m Reload Cursor (Ctrl+Shift+P > \"Reload Window\")");
+    console.log("  \x1b[1m2.\x1b[0m Enter Play mode in Unity");
+    console.log("  \x1b[1m3.\x1b[0m Ask your AI: \"What's the state of my game?\"");
+    console.log();
+    console.log("  \x1b[2m14-day Pro trial included. Cloud vision analysis works automatically.\x1b[0m");
+    console.log();
+  } catch (e) {
+    error(`Setup failed: ${e.message}`);
+    console.log();
+    console.log("  Troubleshooting:");
+    console.log("  - Check your internet connection");
+    console.log("  - Try manual download: https://getaether.dev/download");
+    console.log("  - Run: aether-bridge --doctor");
+    console.log();
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "aether-init",
+  "version": "0.4.0",
+  "description": "One-command installer for Aether - AI co-debugging for Unity",
+  "bin": {
+    "aether-init": "./index.mjs"
+  },
+  "files": ["index.mjs"],
+  "type": "module",
+  "keywords": ["aether", "unity", "mcp", "debugging", "ai", "cursor"],
+  "author": "Finexma",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/finexma-dev/aether.git"
+  }
+}