@scottymade/mana 1.0.0

package/README.md

@@ -0,0 +1,53 @@
+# @scottymade/mana
+
+MANA - LLM Token Usage Optimizer for Claude Code
+
+Optimizes token-heavy tool outputs, saving 50-80% on every operation. Double your Claude Code usage.
+
+## Installation
+
+```bash
+npm install -g @scottymade/mana
+```
+
+## Setup
+
+After installing, you need to configure MANA for your project:
+
+### 1. Get Your API Key
+
+Sign up at [devmana.ai](https://devmana.ai) and create an API key.
+
+### 2. Create `.mcp.json` in your project
+
+```json
+{
+  "mcpServers": {
+    "mana": {
+      "command": "mana",
+      "args": ["--api-key=YOUR_API_KEY"]
+    }
+  }
+}
+```
+
+### 3. Add Claude Instructions
+
+Add the MANA instructions to `.claude/CLAUDE.md` in your project:
+
+```bash
+mkdir -p .claude
+curl -fsSL https://raw.githubusercontent.com/scottymade/mana/main/instructions/CLAUDE_INSTRUCTIONS.md >> .claude/CLAUDE.md
+```
+
+### 4. Restart Claude Code
+
+Run `/mcp` to verify MANA is connected.
+
+## Documentation
+
+Full documentation at [github.com/scottymade/mana](https://github.com/scottymade/mana)
+
+## License
+
+Apache-2.0

package/bin/mana

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# ============================================================================
+# MANA MCP - Wrapper Script
+# ============================================================================
+# This script is the entry point for the mana command.
+# It finds and executes the platform-specific binary that was downloaded
+# during npm postinstall.
+# ============================================================================
+
+set -e
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Try to find the binary
+# First, check for the symlink/copy created by postinstall
+if [ -f "$SCRIPT_DIR/mana-binary" ]; then
+  exec "$SCRIPT_DIR/mana-binary" "$@"
+fi
+
+# Fallback: detect platform and find the specific binary
+OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+ARCH=$(uname -m)
+
+case "$ARCH" in
+  x86_64|amd64) ARCH="x64" ;;
+  arm64|aarch64) ARCH="arm64" ;;
+esac
+
+case "$OS" in
+  darwin) BINARY_NAME="mana-mcp-darwin-$ARCH" ;;
+  linux) BINARY_NAME="mana-mcp-linux-x64" ;;
+  *)
+    echo "Error: Unsupported OS: $OS" >&2
+    exit 1
+    ;;
+esac
+
+BINARY_PATH="$SCRIPT_DIR/$BINARY_NAME"
+
+if [ -f "$BINARY_PATH" ]; then
+  exec "$BINARY_PATH" "$@"
+fi
+
+# Binary not found - postinstall may have failed
+echo "Error: MANA binary not found at $BINARY_PATH" >&2
+echo "Try reinstalling: npm install -g @scottymade/mana" >&2
+exit 1

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@scottymade/mana",
+  "version": "1.0.0",
+  "description": "MANA - LLM Token Usage Optimizer for Claude Code",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "mcp",
+    "token-optimization",
+    "llm"
+  ],
+  "author": "ScottyMade <hi@scottymadellc.com>",
+  "license": "Apache-2.0",
+  "homepage": "https://devmana.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scottymade/mana"
+  },
+  "bugs": {
+    "url": "https://github.com/scottymade/mana/issues"
+  },
+  "bin": {
+    "mana": "./bin/mana"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "bin/",
+    "scripts/"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+// ============================================================================
+// MANA MCP - Postinstall Script
+// ============================================================================
+// This script runs after `npm install` and downloads the correct binary
+// for the user's operating system and architecture.
+//
+// Supported platforms:
+//   - macOS (darwin) arm64 (M1/M2/M3)
+//   - macOS (darwin) x64 (Intel)
+//   - Linux x64
+// ============================================================================
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// ============================================================================
+// Configuration
+// ============================================================================
+
+const REPO = 'scottymade/mana';
+const GITHUB_RELEASES_URL = `https://github.com/${REPO}/releases/latest/download`;
+
+// Map of platform/arch to binary name
+const BINARY_MAP = {
+  'darwin-arm64': 'mana-mcp-darwin-arm64',
+  'darwin-x64': 'mana-mcp-darwin-x64',
+  'linux-x64': 'mana-mcp-linux-x64',
+};
+
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+/**
+ * Get the binary name for the current platform
+ */
+function getBinaryName() {
+  const platform = process.platform;
+  const arch = process.arch;
+  const key = `${platform}-${arch}`;
+
+  const binaryName = BINARY_MAP[key];
+
+  if (!binaryName) {
+    console.error(`\nError: Unsupported platform: ${platform}-${arch}`);
+    console.error('MANA supports: macOS (arm64, x64), Linux (x64)\n');
+    process.exit(1);
+  }
+
+  return binaryName;
+}
+
+/**
+ * Download a file from URL to destination
+ * Follows redirects (GitHub releases redirect to S3)
+ */
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+
+    const request = (url) => {
+      https.get(url, (response) => {
+        // Handle redirects (GitHub releases return 302)
+        if (response.statusCode === 301 || response.statusCode === 302) {
+          const redirectUrl = response.headers.location;
+          request(redirectUrl);
+          return;
+        }
+
+        if (response.statusCode !== 200) {
+          reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+          return;
+        }
+
+        response.pipe(file);
+
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+      }).on('error', (err) => {
+        fs.unlink(dest, () => {}); // Delete partial file
+        reject(err);
+      });
+    };
+
+    request(url);
+  });
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function main() {
+  const binaryName = getBinaryName();
+  const downloadUrl = `${GITHUB_RELEASES_URL}/${binaryName}`;
+  const binDir = path.join(__dirname, '..', 'bin');
+  const binaryPath = path.join(binDir, binaryName);
+
+  console.log(`\nMANA: Installing ${binaryName}...`);
+
+  // Ensure bin directory exists
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  // Download the binary
+  try {
+    await downloadFile(downloadUrl, binaryPath);
+  } catch (error) {
+    console.error(`\nError downloading MANA binary: ${error.message}`);
+    console.error(`URL: ${downloadUrl}\n`);
+    process.exit(1);
+  }
+
+  // Make it executable
+  fs.chmodSync(binaryPath, 0o755);
+
+  // Create a symlink or copy as 'mana-binary' so the wrapper can find it
+  const symlinkPath = path.join(binDir, 'mana-binary');
+  try {
+    if (fs.existsSync(symlinkPath)) {
+      fs.unlinkSync(symlinkPath);
+    }
+    // Use copy instead of symlink for better cross-platform support
+    fs.copyFileSync(binaryPath, symlinkPath);
+    fs.chmodSync(symlinkPath, 0o755);
+  } catch (error) {
+    // If copy fails, the wrapper will fall back to detecting the binary
+    console.warn(`Warning: Could not create binary link: ${error.message}`);
+  }
+
+  console.log('MANA: Installation complete!\n');
+  console.log('Next steps:');
+  console.log('  1. Create .mcp.json in your project (see README)');
+  console.log('  2. Add MANA instructions to .claude/CLAUDE.md');
+  console.log('  3. Restart Claude Code\n');
+}
+
+main().catch((error) => {
+  console.error('MANA installation failed:', error.message);
+  process.exit(1);
+});