@polarityinc/paragon 0.0.9 → 0.0.11

package/README.md

@@ -103,6 +103,38 @@ Paragon uses Language Server Protocol (LSP) for deep code understanding, just li
 ### Extensible via MCP
 Add capabilities through Model Context Protocol (`http`, `stdio`, and `sse` transports).
 
+Paragon ships with a Claude-compatible MCP CLI so you can manage servers without leaving the terminal:
+
+```bash
+# Add stdio server locally (stored in .paragon/mcp.local.json)
+paragon mcp add local-filesystem --transport stdio --env ROOT=/work -- ls --color=never
+
+# Share a server with your team via .mcp.json
+paragon mcp add github --transport http --scope project https://api.githubcopilot.com/mcp/
+
+# Inspect and manage servers
+paragon mcp list
+paragon mcp get github
+paragon mcp remove local-filesystem --scope local
+
+# Supabase works exactly like Claude
+paragon mcp add --scope project --transport http supabase https://mcp.supabase.com/mcp
+paragon mcp auth supabase
+
+# Install every catalog MCP in one shot
+paragon mcp catalog install --all --scope project
+```
+
+Scopes mirror Claude Code:
+
+- `local` (default) → private to you per project, saved under `.paragon/mcp.local.json`
+- `project` → shared `.mcp.json` in the repo root
+- `user` → stored in your global Paragon config so every project can use it
+
+The command palette’s **Add MCP Server** dialog now follows the same flow (scope selection, auth metadata, env vars) and will launch OAuth URLs automatically when provided. Supabase servers trigger the full Claude-style OAuth handshake (local callback server, PKCE, browser open) and save the resulting token to your local `.paragon/mcp.tokens.json`. For instant setup, run `paragon mcp catalog install --all --scope project` to pull in every curated MCP from the catalog; the `/mcp` dialog will walk you through approving and authenticating each one.
+
+Inside the TUI, type `/mcp` (or run **Manage MCP Servers** from the command palette) to review servers, authenticate via browser, or disable entries. Project-scoped MCPs from `.mcp.json` prompt you to approve or reject them before Paragon connects, mirroring Claude Code’s safety flow.
+
 ### Works Everywhere
 First-class support in every terminal on macOS, Linux, Windows (PowerShell and WSL), FreeBSD, OpenBSD, and NetBSD.
 
@@ -203,4 +235,3 @@ For inquiries, contact [sales@polarity.cc](mailto:sales@polarity.cc).
 </p>
 
 ---
-

package/bin/paragon

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Determine platform
+const platform = process.platform === 'win32' ? 'windows' : process.platform;
+const binaryName = platform === 'windows' ? 'paragon.exe' : 'paragon-bin';
+const binaryPath = path.join(__dirname, binaryName);
+
+// Check if binary exists
+if (!fs.existsSync(binaryPath)) {
+  console.error('Error: Paragon binary not found.');
+  console.error('Please reinstall: npm install -g @polarityinc/paragon');
+  process.exit(1);
+}
+
+// Execute the binary with all arguments
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  shell: false
+});
+
+child.on('exit', (code) => {
+  process.exit(code);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polarityinc/paragon",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "Paragon is the First AI QA Engineer and the Worlds best code reviewer.",
   "author": "Polarity Inc.",
   "private": false,

package/scripts/npm-install.js

@@ -39,7 +39,7 @@ const GITHUB_RELEASE_URL = `https://github.com/Polarityinc/polarity-binaries/rel
 
 // Create bin directory
 const binDir = path.join(__dirname, '..', 'bin');
-const binPath = path.join(binDir, platform === 'windows' ? 'paragon.exe' : 'paragon');
+const binPath = path.join(binDir, platform === 'windows' ? 'paragon.exe' : 'paragon-bin');
 
 if (!fs.existsSync(binDir)) {
   fs.mkdirSync(binDir, { recursive: true });
@@ -162,6 +162,33 @@ function installRipgrep() {
   }
 }
 
+// Uninstall brew version if it exists
+function uninstallBrewPolarity() {
+  if (platform !== 'darwin') {
+    return; // Only relevant for macOS
+  }
+
+  try {
+    // Check if brew is available
+    execSync('brew --version', { stdio: 'ignore' });
+
+    // Check if polarity is installed via brew
+    try {
+      execSync('brew list polarity', { stdio: 'ignore' });
+      console.log('Found existing Homebrew installation of polarity, uninstalling...');
+      execSync('brew uninstall polarity', { stdio: 'inherit' });
+      console.log('✓ Homebrew polarity uninstalled successfully\n');
+    } catch (e) {
+      // polarity not installed via brew, which is fine
+    }
+  } catch (e) {
+    // brew not available, skip
+  }
+}
+
+// Uninstall brew version before installing npm version
+uninstallBrewPolarity();
+
 downloadFile(GITHUB_RELEASE_URL, binPath)
   .then(() => {
     // Make binary executable on Unix systems
@@ -169,26 +196,42 @@ downloadFile(GITHUB_RELEASE_URL, binPath)
       fs.chmodSync(binPath, 0o755);
     }
 
-    console.log('✓ Paragon installed successfully!');
+    // ASCII Art Logo
+    console.log('\n');
+    console.log('  ██████╗  █████╗ ██████╗  █████╗  ██████╗  ██████╗ ███╗   ██╗');
+    console.log('  ██╔══██╗██╔══██╗██╔══██╗██╔══██╗██╔════╝ ██╔═══██╗████╗  ██║');
+    console.log('  ██████╔╝███████║██████╔╝███████║██║  ███╗██║   ██║██╔██╗ ██║');
+    console.log('  ██╔═══╝ ██╔══██║██╔══██╗██╔══██║██║   ██║██║   ██║██║╚██╗██║');
+    console.log('  ██║     ██║  ██║██║  ██║██║  ██║╚██████╔╝╚██████╔╝██║ ╚████║');
+    console.log('  ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═══╝');
+    console.log('\n  The Best Code Review Agent in the World\n');
+    console.log('✓ Paragon installed successfully!\n');
 
     // Check and install ripgrep if needed
     if (!checkRipgrep()) {
-      console.log('\nripgrep is required but not found.');
       if (!installRipgrep()) {
-        console.log('\n⚠️  Warning: Paragon requires ripgrep to function properly');
-        console.log('Please install it manually: https://github.com/BurntSushi/ripgrep#installation');
+        console.log('⚠️  Could not auto-install ripgrep');
+        console.log('Please install it manually: https://github.com/BurntSushi/ripgrep#installation\n');
       } else {
-        console.log('✓ ripgrep installed successfully!');
+        console.log('✓ ripgrep installed automatically!\n');
       }
     }
 
-    console.log(`\nTo get started, run: paragon`);
-    console.log('For authentication, run: paragon auth login');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('\n📝 Next Steps:\n');
+    console.log('  1. Authenticate with Polarity:');
+    console.log('     $ paragon auth login\n');
+    console.log('  2. Get your API key from:');
+    console.log('     https://home.polarity.cc/app/settings\n');
+    console.log('  3. Start using Paragon:');
+    console.log('     $ paragon\n');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('\n📚 Documentation: https://polarity.cc/docs');
+    console.log('💬 Support: sales@polarity.cc\n');
   })
   .catch((err) => {
     console.error('✗ Installation failed:', err.message);
     console.error('\nPlease try one of these alternatives:');
-    console.error('- Homebrew: brew install polarityinc/polarity/polarity');
     console.error('- Direct download: https://github.com/Polarityinc/polarity-binaries/releases');
     process.exit(1);
   });