@tummycrypt/remote-juggler 2.1.0-beta.2

package/README.md

@@ -0,0 +1,73 @@
+# @tummycrypt/remote-juggler
+
+Multi-provider git identity management with MCP server support for AI agents.
+
+## Quick Start
+
+### As an MCP Server (for AI agents)
+
+Add to your MCP client configuration (Claude Code, Cursor, VS Code):
+
+```json
+{
+  "mcpServers": {
+    "remote-juggler": {
+      "command": "npx",
+      "args": ["-y", "@tummycrypt/remote-juggler", "--mode=mcp"]
+    }
+  }
+}
+```
+
+### As a CLI Tool
+
+```bash
+npx @tummycrypt/remote-juggler list
+npx @tummycrypt/remote-juggler switch gitlab-personal
+npx @tummycrypt/remote-juggler status
+```
+
+### Full Installation
+
+For a permanent installation with shell completions and IDE integration:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Jesssullivan/RemoteJuggler/main/install.sh | bash
+```
+
+## What It Does
+
+RemoteJuggler manages multiple git identities across providers (GitLab, GitHub, Bitbucket). It handles:
+
+- SSH key selection per identity
+- GPG signing configuration
+- Git user.name/user.email switching
+- Credential resolution (Keychain, env vars, SSH agent)
+- Automatic identity detection from repository remotes
+
+## MCP Tools
+
+When running as an MCP server, these tools are available to AI agents:
+
+| Tool | Description |
+|------|-------------|
+| `juggler_list_identities` | List all configured identities |
+| `juggler_detect_identity` | Auto-detect identity from repo remote URL |
+| `juggler_switch` | Switch to a different identity |
+| `juggler_status` | Get current identity and git config status |
+| `juggler_validate` | Test SSH/API connectivity for an identity |
+| `juggler_store_token` | Store API token in keychain |
+| `juggler_sync_config` | Synchronize managed SSH/git config blocks |
+
+## Supported Platforms
+
+- Linux x86_64
+- Linux ARM64
+- macOS x86_64 (Intel)
+- macOS ARM64 (Apple Silicon)
+
+## Links
+
+- [GitHub Repository](https://github.com/Jesssullivan/RemoteJuggler)
+- [Full Documentation](https://github.com/Jesssullivan/RemoteJuggler/blob/main/README.md)
+- [MCP Registry](https://modelcontextprotocol.io)

package/bin/cli.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+/**
+ * RemoteJuggler CLI wrapper
+ *
+ * Spawns the platform-native binary with all arguments and stdio inherited,
+ * forwarding the exit code. This enables the `npx @tummycrypt/remote-juggler`
+ * and `npx @tummycrypt/remote-juggler --mode=mcp` usage patterns.
+ */
+
+const { spawn } = require("child_process");
+const { join } = require("path");
+const { existsSync } = require("fs");
+
+const BINARY_PATH = join(__dirname, "remote-juggler-binary");
+
+if (!existsSync(BINARY_PATH)) {
+  console.error("RemoteJuggler binary not found. Run: npm install @tummycrypt/remote-juggler");
+  console.error("Or install directly: curl -fsSL https://raw.githubusercontent.com/Jesssullivan/RemoteJuggler/main/install.sh | bash");
+  process.exit(1);
+}
+
+const child = spawn(BINARY_PATH, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+child.on("error", (err) => {
+  console.error(`Failed to start RemoteJuggler: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code || 0);
+  }
+});

package/bin/install.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * RemoteJuggler npm postinstall script
+ *
+ * Downloads the correct platform-specific binary from GitHub Releases
+ * and places it alongside this script for the CLI wrapper to invoke.
+ */
+
+const { createWriteStream, chmodSync, existsSync } = require("fs");
+const { join } = require("path");
+const https = require("https");
+const { execSync } = require("child_process");
+
+const pkg = require("../package.json");
+const VERSION = pkg.version;
+const BINARY_PATH = join(__dirname, "remote-juggler-binary");
+
+// Map Node.js platform/arch to GitHub Release asset names
+const PLATFORM_MAP = {
+  "linux-x64": "remote-juggler-linux-amd64",
+  "linux-arm64": "remote-juggler-linux-arm64",
+  "darwin-x64": "remote-juggler-darwin-amd64",
+  "darwin-arm64": "remote-juggler-darwin-arm64",
+};
+
+function getPlatformKey() {
+  return `${process.platform}-${process.arch}`;
+}
+
+function getDownloadUrl() {
+  const key = getPlatformKey();
+  const asset = PLATFORM_MAP[key];
+  if (!asset) {
+    if (process.platform === "win32") {
+      console.error("RemoteJuggler does not have a native Windows build.");
+      console.error("Use WSL (Windows Subsystem for Linux) instead:");
+      console.error("  wsl --install && wsl npm install -g @tummycrypt/remote-juggler");
+      console.error("");
+      console.error("Or install in WSL directly:");
+      console.error("  wsl curl -fsSL https://raw.githubusercontent.com/Jesssullivan/RemoteJuggler/main/install.sh | bash");
+    } else {
+      console.error(
+        `Unsupported platform: ${key}. Supported: ${Object.keys(PLATFORM_MAP).join(", ")}`
+      );
+    }
+    process.exit(1);
+  }
+  return `https://github.com/Jesssullivan/RemoteJuggler/releases/download/v${VERSION}/${asset}`;
+}
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const request = https.get(url, (response) => {
+      // Handle redirects (GitHub sends 302 to S3)
+      if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+        return download(response.headers.location).then(resolve).catch(reject);
+      }
+
+      if (response.statusCode !== 200) {
+        reject(new Error(`Download failed: HTTP ${response.statusCode} from ${url}`));
+        return;
+      }
+
+      const file = createWriteStream(BINARY_PATH);
+      response.pipe(file);
+      file.on("finish", () => {
+        file.close();
+        chmodSync(BINARY_PATH, 0o755);
+        resolve();
+      });
+      file.on("error", (err) => {
+        reject(err);
+      });
+    });
+
+    request.on("error", reject);
+    request.setTimeout(60000, () => {
+      request.destroy();
+      reject(new Error("Download timeout (60s)"));
+    });
+  });
+}
+
+async function main() {
+  // Skip download if binary already exists (e.g., local development)
+  if (existsSync(BINARY_PATH)) {
+    console.log("RemoteJuggler binary already exists, skipping download.");
+    return;
+  }
+
+  const url = getDownloadUrl();
+  const key = getPlatformKey();
+  console.log(`Downloading RemoteJuggler v${VERSION} for ${key}...`);
+  console.log(`  URL: ${url}`);
+
+  try {
+    await download(url);
+    console.log(`RemoteJuggler v${VERSION} installed successfully.`);
+
+    // Quick sanity check
+    try {
+      const output = execSync(`"${BINARY_PATH}" --help`, {
+        timeout: 5000,
+        encoding: "utf-8",
+      });
+      if (output.includes("remote-juggler") || output.includes("RemoteJuggler")) {
+        console.log("  Binary verified OK.");
+      }
+    } catch {
+      // Binary may not be fully compatible (e.g., missing libs) but install succeeded
+      console.log("  Binary downloaded (verification skipped).");
+    }
+  } catch (err) {
+    console.error(`Failed to download RemoteJuggler: ${err.message}`);
+    console.error("");
+    console.error("You can install manually:");
+    console.error("  curl -fsSL https://raw.githubusercontent.com/Jesssullivan/RemoteJuggler/main/install.sh | bash");
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@tummycrypt/remote-juggler",
+  "version": "2.1.0-beta.2",
+  "description": "Multi-provider git identity management with MCP server support for AI agents",
+  "bin": {
+    "remote-juggler": "./bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/install.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jesssullivan/RemoteJuggler.git"
+  },
+  "homepage": "https://github.com/Jesssullivan/RemoteJuggler",
+  "keywords": [
+    "mcp",
+    "git",
+    "identity",
+    "gitlab",
+    "github",
+    "ssh",
+    "gpg",
+    "model-context-protocol"
+  ],
+  "license": "Zlib",
+  "os": [
+    "linux",
+    "darwin"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}