@mattstratton/install-marketing-skills 1.0.0

package/README.md

@@ -0,0 +1,40 @@
+# @mattstratton/install-marketing-skills
+
+One-line installer for the **tigerdata-marketing-skills** Cowork (Claude Desktop) plugin.
+
+Workaround for [anthropics/claude-code#40600](https://github.com/anthropics/claude-code/issues/40600) — Cowork's `RemotePluginManager` can wipe marketplace-installed plugins on restart. This installer writes directly to the `LocalPluginsReader` path, which persists.
+
+## Usage
+
+```bash
+# Install or update to the latest version
+npx @mattstratton/install-marketing-skills
+
+# Check if an update is available (doesn't install)
+npx @mattstratton/install-marketing-skills --check
+```
+
+## What it does
+
+1. Fetches the latest release from [timescale/marketing-skills](https://github.com/timescale/marketing-skills/releases)
+2. Downloads the plugin zip (no git clone needed)
+3. Finds your Cowork installation(s)
+4. Installs the plugin into `cowork_plugins/cache/` where it persists across restarts
+5. Enables the plugin in `cowork_settings.json`
+
+**Restart Claude Desktop after running** for changes to take effect.
+
+## Requirements
+
+- Node.js 18+
+- Claude Desktop installed (Cowork must have been opened at least once)
+
+## Platforms
+
+Works on macOS, Windows, and Linux.
+
+On macOS, you can also use the shell script (no Node.js required):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/timescale/marketing-skills/main/scripts/install.sh | bash
+```

package/bin/install.js

@@ -0,0 +1,369 @@
+#!/usr/bin/env node
+'use strict';
+
+// ---------------------------------------------------------------------------
+// install.js — Cross-platform installer for tigerdata-marketing-skills
+//
+// Downloads the latest release zip from GitHub and installs it into the
+// Cowork LocalPluginsReader path, which persists across restarts.
+// Workaround for https://github.com/anthropics/claude-code/issues/40600
+//
+// Usage:
+//   npx @mattstratton/install-marketing-skills            # Install or update
+//   npx @mattstratton/install-marketing-skills --check     # Check if update available
+// ---------------------------------------------------------------------------
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const crypto = require('crypto');
+const { execFileSync } = require('child_process');
+
+// --- Configuration ---------------------------------------------------------
+const REPO = 'timescale/marketing-skills';
+const MARKETPLACE_NAME = 'tigerdata-marketing';
+const PLUGIN_NAME = 'tigerdata-marketing-skills';
+const PLUGIN_KEY = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
+const MARKETPLACE_GITHUB = 'timescale/marketing-skills';
+
+// --- Output helpers --------------------------------------------------------
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const BOLD = '\x1b[1m';
+const NC = '\x1b[0m';
+
+function info(msg) { console.log(`${GREEN}✓${NC} ${msg}`); }
+function warn(msg) { console.log(`${YELLOW}!${NC} ${msg}`); }
+function error(msg) { console.error(`${RED}✗${NC} ${msg}`); process.exit(1); }
+
+// --- HTTP helpers (zero deps) ----------------------------------------------
+function httpsGet(url, redirects = 0) {
+  if (redirects > 10) return Promise.reject(new Error('Too many redirects'));
+  return new Promise((resolve, reject) => {
+    https.get(url, { headers: { 'User-Agent': 'install-marketing-skills' } }, (res) => {
+      // Follow redirects
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return httpsGet(res.headers.location, redirects + 1).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`HTTP ${res.statusCode} from ${url}`));
+      }
+      const chunks = [];
+      res.on('data', (chunk) => chunks.push(chunk));
+      res.on('end', () => resolve(Buffer.concat(chunks)));
+      res.on('error', reject);
+    }).on('error', reject);
+  });
+}
+
+async function fetchJSON(url) {
+  const buf = await httpsGet(url);
+  return JSON.parse(buf.toString('utf-8'));
+}
+
+async function downloadFile(url, destPath) {
+  const buf = await httpsGet(url);
+  fs.writeFileSync(destPath, buf);
+  return buf.length;
+}
+
+// --- Platform detection ----------------------------------------------------
+function getSessionsRoot() {
+  switch (os.platform()) {
+    case 'darwin':
+      return path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'local-agent-mode-sessions');
+    case 'win32': {
+      const appdata = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
+      return path.join(appdata, 'Claude', 'local-agent-mode-sessions');
+    }
+    default: // linux
+      return path.join(os.homedir(), '.config', 'Claude', 'local-agent-mode-sessions');
+  }
+}
+
+// --- Zip extraction (platform-native, no deps) -----------------------------
+function extractZip(zipPath, destDir) {
+  fs.mkdirSync(destDir, { recursive: true });
+  if (os.platform() === 'win32') {
+    // PowerShell's Expand-Archive
+    const escapedZip = zipPath.replace(/"/g, '`"');
+    const escapedDest = destDir.replace(/"/g, '`"');
+    execFileSync('powershell', [
+      '-NoProfile', '-Command',
+      `Expand-Archive -LiteralPath "${escapedZip}" -DestinationPath "${escapedDest}" -Force`,
+    ], { stdio: 'pipe' });
+  } else {
+    execFileSync('unzip', ['-q', zipPath, '-d', destDir], { stdio: 'pipe' });
+  }
+}
+
+// --- JSON helpers ----------------------------------------------------------
+function readJSON(filePath, defaultValue) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+  } catch {
+    return defaultValue !== undefined ? defaultValue : {};
+  }
+}
+
+function writeJSON(filePath, data) {
+  fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+}
+
+// --- File hashing ----------------------------------------------------------
+function sha256File(filePath) {
+  const content = fs.readFileSync(filePath);
+  return crypto.createHash('sha256').update(content).digest('hex');
+}
+
+function collectFileHashes(dir) {
+  const hashes = {};
+  function walk(currentDir) {
+    for (const entry of fs.readdirSync(currentDir, { withFileTypes: true })) {
+      const fullPath = path.join(currentDir, entry.name);
+      if (entry.isDirectory()) {
+        walk(fullPath);
+      } else if (!entry.name.includes('.DS_Store')) {
+        const rel = path.relative(dir, fullPath);
+        // Normalize to forward slashes for cross-platform consistency
+        hashes[rel.split(path.sep).join('/')] = sha256File(fullPath);
+      }
+    }
+  }
+  walk(dir);
+  return hashes;
+}
+
+// --- Discovery -------------------------------------------------------------
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+
+function discoverInstallations(sessionsRoot) {
+  const results = [];
+
+  if (!fs.existsSync(sessionsRoot)) {
+    error(`Sessions directory not found: ${sessionsRoot}\nIs Claude Desktop installed and has Cowork been used at least once?`);
+  }
+
+  for (const acct of fs.readdirSync(sessionsRoot, { withFileTypes: true })) {
+    if (!acct.isDirectory() || !UUID_RE.test(acct.name)) continue;
+    const acctPath = path.join(sessionsRoot, acct.name);
+
+    for (const org of fs.readdirSync(acctPath, { withFileTypes: true })) {
+      if (!org.isDirectory() || org.name.startsWith('.')) continue;
+      const orgPath = path.join(acctPath, org.name);
+      const coworkPlugins = path.join(orgPath, 'cowork_plugins');
+      const coworkSettings = path.join(orgPath, 'cowork_settings.json');
+
+      // Create cowork_plugins structure if org dir has content
+      if (!fs.existsSync(coworkPlugins)) {
+        const contents = fs.readdirSync(orgPath);
+        if (contents.length > 0) {
+          console.log(`  Creating cowork_plugins in ${org.name.slice(0, 8)}...`);
+          fs.mkdirSync(path.join(coworkPlugins, 'marketplaces'), { recursive: true });
+          fs.mkdirSync(path.join(coworkPlugins, 'cache'), { recursive: true });
+          fs.mkdirSync(path.join(coworkPlugins, '.install-manifests'), { recursive: true });
+          writeJSON(path.join(coworkPlugins, 'installed_plugins.json'), { version: 2, plugins: {} });
+          writeJSON(path.join(coworkPlugins, 'known_marketplaces.json'), {});
+        } else {
+          continue;
+        }
+      }
+
+      results.push({ orgName: org.name, coworkPlugins, coworkSettings });
+    }
+  }
+
+  if (results.length === 0) {
+    error('No Cowork installations found.\nIs Claude Desktop installed and has Cowork been used at least once?');
+  }
+
+  return results;
+}
+
+// --- Installation ----------------------------------------------------------
+function installTo(coworkPlugins, coworkSettings, extractDir, version, tagName) {
+  const installedPluginsPath = path.join(coworkPlugins, 'installed_plugins.json');
+  const installedData = readJSON(installedPluginsPath, { version: 2, plugins: {} });
+  const entries = (installedData.plugins || {})[PLUGIN_KEY] || [];
+  const oldVersion = entries.length > 0 ? entries[0].version : null;
+
+  if (oldVersion === version) {
+    console.log(`  Already up to date (v${version})`);
+    return;
+  }
+
+  console.log(`  Updating: v${oldVersion || 'none'} → v${version}`);
+  const now = new Date().toISOString().replace(/\.\d{3}Z$/, '.000Z');
+
+  // Step 1: Populate cache
+  const cacheDir = path.join(coworkPlugins, 'cache', MARKETPLACE_NAME, PLUGIN_NAME, version);
+  if (fs.existsSync(cacheDir)) {
+    fs.rmSync(cacheDir, { recursive: true, force: true });
+  }
+  fs.cpSync(extractDir, cacheDir, { recursive: true });
+
+  const fileHashes = collectFileHashes(cacheDir);
+  const fileCount = Object.keys(fileHashes).length;
+  console.log(`  Cache: ${fileCount} files → ${cacheDir}`);
+
+  // Step 2: Install manifest
+  const manifestDir = path.join(coworkPlugins, '.install-manifests');
+  fs.mkdirSync(manifestDir, { recursive: true });
+  const manifestPath = path.join(manifestDir, `${PLUGIN_KEY}.json`);
+
+  let createdAt = now;
+  const oldManifest = readJSON(manifestPath, null);
+  if (oldManifest) {
+    createdAt = oldManifest.createdAt || now;
+  }
+
+  writeJSON(manifestPath, {
+    pluginId: PLUGIN_KEY,
+    createdAt,
+    files: fileHashes,
+  });
+  console.log(`  Manifest: ${fileCount} file hashes`);
+
+  // Step 3: Update installed_plugins.json
+  installedData.version = installedData.version || 2;
+  installedData.plugins = installedData.plugins || {};
+  const existing = installedData.plugins[PLUGIN_KEY] || [{}];
+  const entry = existing[0] || {};
+  entry.scope = 'user';
+  entry.installPath = cacheDir;
+  entry.version = version;
+  entry.lastUpdated = now;
+  entry.gitCommitSha = tagName;
+  entry.installedAt = entry.installedAt || now;
+  installedData.plugins[PLUGIN_KEY] = [entry];
+  writeJSON(installedPluginsPath, installedData);
+  console.log('  installed_plugins.json: updated');
+
+  // Step 4: Ensure cowork_settings.json
+  const settings = readJSON(coworkSettings);
+  const enabled = settings.enabledPlugins = settings.enabledPlugins || {};
+  if (!enabled[PLUGIN_KEY]) {
+    enabled[PLUGIN_KEY] = true;
+    writeJSON(coworkSettings, settings);
+    console.log('  cowork_settings.json: enabled plugin');
+  } else {
+    console.log('  cowork_settings.json: already enabled');
+  }
+
+  // Step 5: Ensure known_marketplaces.json
+  const knownPath = path.join(coworkPlugins, 'known_marketplaces.json');
+  const known = readJSON(knownPath);
+  if (!known[MARKETPLACE_NAME]) {
+    known[MARKETPLACE_NAME] = {
+      source: { source: 'github', repo: MARKETPLACE_GITHUB },
+      installLocation: path.join(coworkPlugins, 'marketplaces', MARKETPLACE_NAME),
+      lastUpdated: now,
+    };
+    writeJSON(knownPath, known);
+    console.log('  known_marketplaces.json: added marketplace');
+  }
+
+  console.log(`  Installed v${version} (${fileCount} files)`);
+}
+
+// --- Main ------------------------------------------------------------------
+async function main() {
+  const checkOnly = process.argv.includes('--check');
+
+  console.log('');
+  console.log(`${BOLD}${PLUGIN_NAME} installer for Cowork${NC}`);
+  console.log('Workaround for github.com/anthropics/claude-code/issues/40600');
+  console.log('');
+
+  const sessionsRoot = getSessionsRoot();
+  console.log(`Platform: ${os.platform()}`);
+  console.log(`Sessions: ${sessionsRoot}`);
+  console.log('');
+
+  // Fetch latest release
+  console.log('Fetching latest release...');
+  let release;
+  try {
+    release = await fetchJSON(`https://api.github.com/repos/${REPO}/releases/latest`);
+  } catch (err) {
+    error(`Failed to fetch release info: ${err.message}`);
+  }
+
+  const version = release.tag_name.replace(/^v/, '');
+  const tagName = release.tag_name;
+  const zipAsset = (release.assets || []).find((a) => a.name.endsWith('.zip'));
+  if (!zipAsset) {
+    error('No zip asset found in the latest release.');
+  }
+  info(`Latest release: v${version} (${tagName})`);
+
+  // Discover installations
+  const installations = discoverInstallations(sessionsRoot);
+  console.log(`Found ${installations.length} Cowork installation(s)`);
+  console.log('');
+
+  // Check-only mode
+  if (checkOnly) {
+    for (const inst of installations) {
+      const ipPath = path.join(inst.coworkPlugins, 'installed_plugins.json');
+      const data = readJSON(ipPath, { version: 2, plugins: {} });
+      const entries = (data.plugins || {})[PLUGIN_KEY] || [];
+      const installed = entries.length > 0 ? entries[0].version : null;
+      const short = inst.orgName.slice(0, 8);
+
+      if (!installed) {
+        console.log(`  ${short}... Not installed. Run without --check to install.`);
+      } else if (installed === version) {
+        console.log(`  ${short}... Up to date (v${installed})`);
+      } else {
+        console.log(`  ${short}... Update available: v${installed} → v${version}`);
+      }
+    }
+    console.log('');
+    console.log('Done!');
+    return;
+  }
+
+  // Download zip
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'marketing-skills-'));
+  const cleanup = () => { try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch {} };
+  process.on('exit', cleanup);
+  process.on('SIGINT', () => { cleanup(); process.exit(1); });
+
+  const zipFile = path.join(tmpDir, 'plugin.zip');
+  console.log(`Downloading v${version}...`);
+  try {
+    const bytes = await downloadFile(zipAsset.browser_download_url, zipFile);
+    info(`Downloaded ${(bytes / 1024).toFixed(0)} KB zip`);
+  } catch (err) {
+    error(`Failed to download: ${err.message}`);
+  }
+
+  // Extract
+  const extractDir = path.join(tmpDir, 'extracted');
+  try {
+    extractZip(zipFile, extractDir);
+    info('Extracted plugin files');
+  } catch (err) {
+    error(`Failed to extract zip: ${err.message}`);
+  }
+  console.log('');
+
+  // Install to each location
+  let count = 0;
+  for (const inst of installations) {
+    console.log(`--- ${inst.orgName.slice(0, 8)}... ---`);
+    installTo(inst.coworkPlugins, inst.coworkSettings, extractDir, version, tagName);
+    count++;
+    console.log('');
+  }
+
+  console.log(`Done! Installed to ${count} location(s).`);
+  console.log('Restart Claude Desktop for changes to take effect.');
+}
+
+main().catch((err) => {
+  error(err.message);
+});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@mattstratton/install-marketing-skills",
+  "version": "1.0.0",
+  "description": "One-line installer for tigerdata-marketing-skills Cowork plugin. Workaround for github.com/anthropics/claude-code/issues/40600",
+  "bin": {
+    "install-marketing-skills": "./bin/install.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "keywords": [
+    "claude",
+    "cowork",
+    "plugin",
+    "tigerdata",
+    "marketing"
+  ],
+  "author": "Matt Stratton",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/timescale/marketing-skills.git",
+    "directory": "packages/installer"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}