"feat: add @marionette-app/cli npm package"

Author: yarin-mag

.github/workflows/release.yml

@@ -71,4 +71,31 @@ jobs:
       - name: Upload release artifact
         run: gh release upload "${{ github.ref_name }}" "${{ matrix.upload_file }}" --clobber
         env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish-npm:
+    name: Publish @marionette/cli to npm
+    needs: create-release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - name: Set version from tag
+        run: |
+          VERSION="${{ github.ref_name }}"
+          VERSION="${VERSION#v}"
+          npm version "$VERSION" --no-git-tag-version
+        working-directory: packages/cli
+
+      - name: Publish to npm
+        run: npm publish --access public
+        working-directory: packages/cli
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

README.md

@@ -13,17 +13,22 @@ A dashboard that captures every conversation, token count, and tool call across
 
 ## Quick Start (for users)
 
-**macOS / Linux**
+**npm (any platform, Node.js 18+ required)**
+```bash
+npm install -g @marionette-app/cli && marionette setup
+```
+
+**macOS / Linux** (alternative — no Node.js required)
 ```bash
 curl -fsSL https://raw.githubusercontent.com/yarin-mag/Marionette/master/scripts/install.sh | bash
 ```
 
-**Windows** (PowerShell)
+**Windows** (alternative — PowerShell)
 ```powershell
 irm https://raw.githubusercontent.com/yarin-mag/Marionette/master/scripts/install.ps1 | iex
 ```
 
-This downloads the latest release, installs it to `/usr/local/lib/marionette`, registers the MCP server with Claude Code, and configures auto-start.
+This downloads the latest release, installs it to `~/.marionette/app` (npm) or `/usr/local/lib/marionette` (curl/PowerShell), registers the MCP server with Claude Code, and configures auto-start.
 
 After installing, open **http://localhost:8787**.
 

packages/cli/bin/marionette.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+const { spawn } = require('child_process');
+
+const installDir = path.join(os.homedir(), '.marionette', 'app');
+const isWindows = process.platform === 'win32';
+const realBin = path.join(installDir, 'bin', isWindows ? 'marionette.cmd' : 'marionette');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (fs.existsSync(realBin)) {
+  const child = spawn(realBin, args, { stdio: 'inherit', shell: isWindows });
+  child.on('exit', (code) => process.exit(code ?? 0));
+} else if (!command || command === 'setup') {
+  require('../scripts/bootstrap.js')();
+} else {
+  console.error('Marionette is not installed yet. Run: marionette setup');
+  process.exit(1);
+}

packages/cli/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@marionette-app/cli",
+  "version": "1.3.0",
+  "description": "Real-time monitoring for Claude Code sessions",
+  "bin": {
+    "marionette": "./bin/marionette.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yarin-mag/Marionette"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "monitoring",
+    "mcp",
+    "dashboard"
+  ],
+  "files": [
+    "bin/",
+    "scripts/"
+  ]
+}

packages/cli/scripts/bootstrap.js

@@ -0,0 +1,96 @@
+'use strict';
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync, execFileSync } = require('child_process');
+
+module.exports = function bootstrap() {
+  const version = require('../package.json').version;
+  const platform = process.platform;
+  const arch = process.arch;
+  const isWindows = platform === 'win32';
+
+  let artifact;
+  if (platform === 'linux') {
+    artifact = 'marionette-linux-x64.tar.gz';
+  } else if (platform === 'darwin') {
+    artifact = arch === 'arm64'
+      ? 'marionette-macos-arm64.tar.gz'
+      : 'marionette-macos-x64.tar.gz';
+  } else if (isWindows) {
+    artifact = 'marionette-windows-x64.zip';
+  } else {
+    console.error(`Unsupported platform: ${platform}`);
+    process.exit(1);
+  }
+
+  const url = `https://github.com/yarin-mag/Marionette/releases/download/v${version}/${artifact}`;
+  const installDir = path.join(os.homedir(), '.marionette', 'app');
+  const tmpFile = path.join(os.tmpdir(), artifact);
+  const realBin = path.join(installDir, 'bin', isWindows ? 'marionette.cmd' : 'marionette');
+
+  console.log(`Installing Marionette v${version}...`);
+  console.log(`Downloading ${artifact}...`);
+
+  download(url, tmpFile, () => {
+    console.log('Extracting...');
+    fs.mkdirSync(installDir, { recursive: true });
+
+    if (isWindows) {
+      execSync(`tar -xf "${tmpFile}" -C "${installDir}" --strip-components=1`, { stdio: 'inherit' });
+    } else {
+      execSync(`tar -xzf "${tmpFile}" -C "${installDir}" --strip-components=1`, { stdio: 'inherit' });
+      fs.chmodSync(realBin, 0o755);
+    }
+
+    try { fs.unlinkSync(tmpFile); } catch (_) {}
+
+    console.log('Running setup...');
+    execFileSync(realBin, ['setup'], { stdio: 'inherit', shell: isWindows });
+  });
+};
+
+function download(url, dest, callback) {
+  const file = fs.createWriteStream(dest);
+
+  function get(urlStr) {
+    https.get(urlStr, (res) => {
+      if (res.statusCode === 301 || res.statusCode === 302) {
+        file.destroy();
+        get(res.headers.location);
+        return;
+      }
+      if (res.statusCode !== 200) {
+        console.error(`Download failed: HTTP ${res.statusCode}\nURL: ${urlStr}`);
+        process.exit(1);
+      }
+
+      const total = parseInt(res.headers['content-length'] || '0', 10);
+      let received = 0;
+
+      res.on('data', (chunk) => {
+        received += chunk.length;
+        if (total) {
+          const pct = Math.round((received / total) * 100);
+          process.stdout.write(`\r  ${pct}%`);
+        }
+      });
+
+      res.pipe(file);
+      file.on('finish', () => {
+        file.close(() => {
+          if (total) process.stdout.write('\n');
+          callback();
+        });
+      });
+    }).on('error', (err) => {
+      fs.unlink(dest, () => {});
+      console.error(`Download error: ${err.message}`);
+      process.exit(1);
+    });
+  }
+
+  get(url);
+}