-## 🎉 **What's New in V4**
+## 🎉 **What's New in V2.0**
-> *Version 4 brings significant improvements based on community feedback and real-world usage patterns.*
+> *Version 2.0 brings architectural transformation: migration from 27 slash commands to 3 TypeScript plugins with hot reload and auto-activation.*
@@ -252,12 +263,13 @@ pip install --break-system-packages SuperClaude
|
-### 📝 **Improved Namespace**
-**`/sc:` prefix** for all commands:
-- No conflicts with custom commands
-- 25 commands covering full lifecycle
-- From brainstorming to deployment
-- Clean, organized command structure
+### 🔥 **TypeScript Plugins**
+**3 core plugins** with hot reload:
+- **PM Agent**: Confidence-driven orchestration (≥90% threshold)
+- **Research**: Deep web search with adaptive planning
+- **Index**: 94% token reduction (58K → 3K)
+- Auto-activation via SessionStart hook
+- Edit → Save → Instant reflection (no restart)
|
@@ -265,14 +277,14 @@ pip install --break-system-packages SuperClaude
### 🔧 **MCP Server Integration**
-**8 powerful servers** working together:
-- **Context7** → Up-to-date documentation
-- **Sequential** → Complex analysis
+**8 powerful servers** (via airis-mcp-gateway):
+- **Tavily** → Primary web search (Deep Research)
+- **Serena** → Session persistence & memory
+- **Mindbase** → Cross-session learning (zero-footprint)
+- **Sequential** → Token-efficient reasoning
+- **Context7** → Official documentation lookup
+- **Playwright** → JavaScript-heavy content extraction
- **Magic** → UI component generation
-- **Playwright** → Browser testing
-- **Morphllm** → Bulk transformations
-- **Serena** → Session persistence
-- **Tavily** → Web search for deep research
- **Chrome DevTools** → Performance analysis
|
@@ -376,16 +388,16 @@ SuperClaude v4.2 introduces comprehensive Deep Research capabilities, enabling a
```bash
# Basic research with automatic depth
-/sc:research "latest AI developments 2024"
+/research "latest AI developments 2024"
-# Controlled research depth
-/sc:research "quantum computing breakthroughs" --depth exhaustive
+# Controlled research depth (via options in TypeScript)
+/research "quantum computing breakthroughs" # depth: exhaustive
# Specific strategy selection
-/sc:research "market analysis" --strategy planning-only
+/research "market analysis" # strategy: planning-only
-# Domain-filtered research
-/sc:research "React patterns" --domains "reactjs.org,github.com"
+# Domain-filtered research (Tavily MCP integration)
+/research "React patterns" # domains: reactjs.org,github.com
```
### **Research Depth Levels**
@@ -435,8 +447,8 @@ The Deep Research system intelligently coordinates multiple tools:
-- 🎯 [**Commands Reference**](docs/user-guide/commands.md)
- *All 25 slash commands*
+- 🎯 [**Plugin Commands**](docs/user-guide/commands.md)
+ *3 core plugin commands*
- 🤖 [**Agents Guide**](docs/user-guide/agents.md)
*15 specialized agents*
diff --git a/bin/check_env.js b/bin/check_env.js
deleted file mode 100644
index 90af1c1..0000000
--- a/bin/check_env.js
+++ /dev/null
@@ -1,60 +0,0 @@
-const { spawnSync } = require("child_process");
-
-function run(cmd, args = [], opts = {}) {
- return spawnSync(cmd, args, {
- stdio: opts.stdio || "pipe",
- shell: true
- });
-}
-
-function checkCommand(cmd, args = ["--version"]) {
- const result = run(cmd, args);
- return result.status === 0;
-}
-
-function detectPython() {
- const candidates = ["python3", "python", "py"];
- for (let c of candidates) {
- if (checkCommand(c)) return c;
- }
- return null;
-}
-
-function detectPip() {
- const candidates = ["pip3", "pip", "py -m pip"];
- for (let c of candidates) {
- if (checkCommand(c.split(" ")[0])) return c;
- }
- return null;
-}
-
-function detectPipx() {
- if (checkCommand("pipx")) return "pipx";
- return null;
-}
-
-function isSuperClaudeInstalled(pipCmd) {
- const result = run(pipCmd, ["show", "SuperClaude"]);
- return result.status === 0;
-}
-
-function isSuperClaudeInstalledPipx() {
- const result = run("pipx", ["list"]);
- if (result.status === 0 && result.stdout) {
- return result.stdout.toString().includes("SuperClaude");
- }
- return false;
-}
-
-function checkPythonEnvironment() {
- // Check if we're in an externally managed environment (PEP 668)
- const result = run("python3", ["-c", "import sysconfig; print(sysconfig.get_path('stdlib'))"]);
- if (result.status === 0 && result.stdout) {
- const stdlibPath = result.stdout.toString().trim();
- const checkPep668 = run("test", ["-f", `${stdlibPath}/EXTERNALLY-MANAGED`]);
- return checkPep668.status === 0;
- }
- return false;
-}
-
-module.exports = { run, detectPython, detectPip, detectPipx, isSuperClaudeInstalled, isSuperClaudeInstalledPipx, checkPythonEnvironment };
diff --git a/bin/check_update.js b/bin/check_update.js
deleted file mode 100644
index f9c4b6d..0000000
--- a/bin/check_update.js
+++ /dev/null
@@ -1,276 +0,0 @@
-#!/usr/bin/env node
-/**
- * Auto-update checker for SuperClaude NPM package
- * Checks npm registry for newer versions and offers automatic updates
- */
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-const https = require('https');
-
-const CACHE_FILE = path.join(process.env.HOME || process.env.USERPROFILE, '.claude', '.npm_update_check');
-const CHECK_INTERVAL = 86400000; // 24 hours in milliseconds
-const TIMEOUT = 2000; // 2 seconds
-const PACKAGE_NAME = '@bifrost_inc/superclaude';
-
-/**
- * Get the current package version from package.json
- */
-function getCurrentVersion() {
- try {
- const packagePath = path.join(__dirname, '..', 'package.json');
- const packageData = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
- return packageData.version;
- } catch (error) {
- return null;
- }
-}
-
-/**
- * Check if we should perform an update check based on last check time
- */
-function shouldCheckUpdate(force = false) {
- if (force) return true;
-
- try {
- if (!fs.existsSync(CACHE_FILE)) return true;
-
- const data = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'));
- const lastCheck = data.lastCheck || 0;
-
- // Check if 24 hours have passed
- return Date.now() - lastCheck > CHECK_INTERVAL;
- } catch {
- return true;
- }
-}
-
-/**
- * Save the current timestamp as last check time
- */
-function saveCheckTimestamp() {
- const cacheDir = path.dirname(CACHE_FILE);
-
- // Create directory if it doesn't exist
- if (!fs.existsSync(cacheDir)) {
- fs.mkdirSync(cacheDir, { recursive: true });
- }
-
- let data = {};
- try {
- if (fs.existsSync(CACHE_FILE)) {
- data = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'));
- }
- } catch {
- // Ignore errors
- }
-
- data.lastCheck = Date.now();
- fs.writeFileSync(CACHE_FILE, JSON.stringify(data, null, 2));
-}
-
-/**
- * Query npm registry for the latest version
- */
-function getLatestVersion() {
- return new Promise((resolve) => {
- const options = {
- hostname: 'registry.npmjs.org',
- path: `/${PACKAGE_NAME}/latest`,
- method: 'GET',
- timeout: TIMEOUT,
- headers: {
- 'User-Agent': 'SuperClaude-Updater'
- }
- };
-
- const req = https.request(options, (res) => {
- let data = '';
-
- res.on('data', (chunk) => {
- data += chunk;
- });
-
- res.on('end', () => {
- try {
- const packageData = JSON.parse(data);
- resolve(packageData.version);
- } catch {
- resolve(null);
- }
- });
- });
-
- req.on('error', () => resolve(null));
- req.on('timeout', () => {
- req.destroy();
- resolve(null);
- });
-
- req.setTimeout(TIMEOUT);
- req.end();
- });
-}
-
-/**
- * Compare version strings
- */
-function isNewerVersion(current, latest) {
- if (!current || !latest) return false;
-
- const currentParts = current.split('.').map(Number);
- const latestParts = latest.split('.').map(Number);
-
- for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
- const currentPart = currentParts[i] || 0;
- const latestPart = latestParts[i] || 0;
-
- if (latestPart > currentPart) return true;
- if (latestPart < currentPart) return false;
- }
-
- return false;
-}
-
-/**
- * Detect if npm or yarn is being used globally
- */
-function detectPackageManager() {
- // Check if installed globally with npm
- const npmResult = spawnSync('npm', ['list', '-g', PACKAGE_NAME], {
- encoding: 'utf8',
- shell: true
- });
-
- if (npmResult.status === 0 && npmResult.stdout.includes(PACKAGE_NAME)) {
- return 'npm';
- }
-
- // Check if installed globally with yarn
- const yarnResult = spawnSync('yarn', ['global', 'list'], {
- encoding: 'utf8',
- shell: true
- });
-
- if (yarnResult.status === 0 && yarnResult.stdout.includes(PACKAGE_NAME)) {
- return 'yarn';
- }
-
- return 'npm'; // Default to npm
-}
-
-/**
- * Get the appropriate update command
- */
-function getUpdateCommand() {
- const pm = detectPackageManager();
-
- if (pm === 'yarn') {
- return `yarn global upgrade ${PACKAGE_NAME}`;
- }
-
- return `npm update -g ${PACKAGE_NAME}`;
-}
-
-/**
- * Show update banner
- */
-function showUpdateBanner(currentVersion, latestVersion, autoUpdate = false) {
- const updateCmd = getUpdateCommand();
-
- console.log('\n\x1b[36m╔════════════════════════════════════════════════╗\x1b[0m');
- console.log(`\x1b[36m║\x1b[33m 🚀 Update Available: ${currentVersion} → ${latestVersion} \x1b[36m║\x1b[0m`);
- console.log(`\x1b[36m║\x1b[32m Run: ${updateCmd.padEnd(30)} \x1b[36m║\x1b[0m`);
- console.log('\x1b[36m╚════════════════════════════════════════════════╝\x1b[0m\n');
-
- return autoUpdate || process.env.SUPERCLAUDE_AUTO_UPDATE === 'true';
-}
-
-/**
- * Perform the update
- */
-function performUpdate() {
- const updateCmd = getUpdateCommand();
- console.log('\x1b[36m🔄 Updating SuperClaude...\x1b[0m');
-
- const cmdParts = updateCmd.split(' ');
- const result = spawnSync(cmdParts[0], cmdParts.slice(1), {
- stdio: 'inherit',
- shell: true
- });
-
- if (result.status === 0) {
- console.log('\x1b[32m✅ Update completed successfully!\x1b[0m');
- console.log('\x1b[33mPlease restart SuperClaude to use the new version.\x1b[0m');
- return true;
- } else {
- console.log('\x1b[33m⚠️ Update failed. Please run manually:\x1b[0m');
- console.log(` ${updateCmd}`);
- return false;
- }
-}
-
-/**
- * Main function to check and notify for updates
- */
-async function checkAndNotify(options = {}) {
- const { force = false, autoUpdate = false, silent = false } = options;
-
- // Check environment variables
- if (process.env.SUPERCLAUDE_NO_UPDATE_CHECK === 'true') {
- return false;
- }
-
- // Check if enough time has passed
- if (!shouldCheckUpdate(force)) {
- return false;
- }
-
- // Get current version
- const currentVersion = getCurrentVersion();
- if (!currentVersion) {
- return false;
- }
-
- // Get latest version
- const latestVersion = await getLatestVersion();
- if (!latestVersion) {
- return false;
- }
-
- // Save timestamp
- saveCheckTimestamp();
-
- // Compare versions
- if (!isNewerVersion(currentVersion, latestVersion)) {
- return false;
- }
-
- // Show banner unless silent
- if (!silent) {
- const shouldUpdate = showUpdateBanner(currentVersion, latestVersion, autoUpdate);
-
- if (shouldUpdate) {
- return performUpdate();
- }
- }
-
- return false;
-}
-
-// Export functions for use in other modules
-module.exports = {
- checkAndNotify,
- getCurrentVersion,
- getLatestVersion,
- isNewerVersion
-};
-
-// If run directly, perform check
-if (require.main === module) {
- checkAndNotify({
- force: process.argv.includes('--force'),
- autoUpdate: process.argv.includes('--auto-update')
- });
-}
\ No newline at end of file
diff --git a/bin/cli.js b/bin/cli.js
deleted file mode 100644
index f46d39f..0000000
--- a/bin/cli.js
+++ /dev/null
@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-const { spawnSync } = require("child_process");
-const { detectPython, detectPip } = require("./check_env");
-const { checkAndNotify } = require("./check_update");
-
-let pythonCmd = detectPython();
-if (!pythonCmd) {
- console.error("❌ Python 3 is required but not found.");
- process.exit(1);
-}
-
-const args = process.argv.slice(2);
-
-// Parse command line arguments for update control
-const noUpdateCheck = args.includes('--no-update-check');
-const autoUpdate = args.includes('--auto-update');
-const isQuiet = args.includes('--quiet') || args.includes('-q');
-
-// Special case: update command
-if (args[0] === "update") {
- require("./update");
- process.exit(0);
-}
-
-// Check for updates unless disabled
-if (!noUpdateCheck && !isQuiet) {
- // Run update check asynchronously to avoid blocking
- checkAndNotify({
- autoUpdate: autoUpdate,
- silent: false
- }).then(updated => {
- if (updated) {
- console.log("\n🔄 SuperClaude was updated. Please restart to use the new version.");
- process.exit(0);
- }
- }).catch(() => {
- // Silently ignore update check errors
- });
-}
-
-// Forward everything to Python SuperClaude
-const result = spawnSync(pythonCmd, ["-m", "SuperClaude", ...args], { stdio: "inherit", shell: true });
-process.exit(result.status);
-
diff --git a/bin/install.js b/bin/install.js
deleted file mode 100644
index fd73310..0000000
--- a/bin/install.js
+++ /dev/null
@@ -1,114 +0,0 @@
-#!/usr/bin/env node
-const { run, detectPython, detectPip, detectPipx, isSuperClaudeInstalled, isSuperClaudeInstalledPipx, checkPythonEnvironment } = require("./check_env");
-
-console.log("🔍 Checking environment...");
-
-let pythonCmd = detectPython();
-if (!pythonCmd) {
- console.error("❌ Python 3 is required but not found.");
- console.error(" Please install Python 3.8 or later from https://python.org");
- process.exit(1);
-}
-console.log(`✅ Found Python: ${pythonCmd}`);
-
-// Check if we're in an externally managed environment (PEP 668)
-const isExternallyManaged = checkPythonEnvironment();
-let installMethod = null;
-let isInstalled = false;
-
-if (isExternallyManaged) {
- console.log("📦 Detected externally managed Python environment (PEP 668)");
-
- // Try pipx first for externally managed environments
- let pipxCmd = detectPipx();
- if (pipxCmd) {
- console.log(`✅ Found pipx: ${pipxCmd}`);
- installMethod = "pipx";
- isInstalled = isSuperClaudeInstalledPipx();
- } else {
- console.log("⚠️ pipx is recommended for this system but not found.");
- console.log(" You can install pipx with: apt install pipx (Ubuntu/Debian) or brew install pipx (macOS)");
- console.log(" Alternatively, use one of these:");
- console.log(" pip install --user SuperClaude # Recommended");
- console.log(" pip install --break-system-packages SuperClaude # Force (use with caution)");
-
- // Fall back to pip with --user flag
- let pipCmd = detectPip();
- if (pipCmd) {
- console.log(`✅ Found pip: ${pipCmd}`);
- console.log(" Will attempt installation with --user flag");
- installMethod = "pip-user";
- isInstalled = isSuperClaudeInstalled(pipCmd);
- } else {
- console.error("❌ Neither pipx nor pip found. Please install one of them.");
- process.exit(1);
- }
- }
-} else {
- // Standard environment - use pip normally
- let pipCmd = detectPip();
- if (!pipCmd) {
- console.error("❌ pip is required but not found.");
- console.error(" Please install pip or use your system's package manager");
- process.exit(1);
- }
- console.log(`✅ Found pip: ${pipCmd}`);
- installMethod = "pip";
- isInstalled = isSuperClaudeInstalled(pipCmd);
-}
-
-// Perform installation based on detected method
-if (!isInstalled) {
- console.log("📦 Installing SuperClaude from PyPI...");
-
- let result;
- switch(installMethod) {
- case "pipx":
- result = run("pipx", ["install", "SuperClaude"], { stdio: "inherit" });
- break;
- case "pip-user":
- result = run(detectPip(), ["install", "--user", "SuperClaude"], { stdio: "inherit" });
- break;
- case "pip":
- result = run(detectPip(), ["install", "SuperClaude"], { stdio: "inherit" });
- break;
- }
-
- if (result.status !== 0) {
- console.error("❌ Installation failed.");
- if (installMethod === "pip" && isExternallyManaged) {
- console.error(" Your system requires pipx or --user flag for pip installations.");
- console.error(" Try: pipx install SuperClaude");
- console.error(" Or: pip install --user SuperClaude");
- }
- process.exit(1);
- }
- console.log("✅ SuperClaude installed successfully!");
-
- // For pipx installations, ensure it's in PATH
- if (installMethod === "pipx") {
- console.log("\n📌 Note: If 'SuperClaude' command is not found, run:");
- console.log(" pipx ensurepath");
- console.log(" Then restart your terminal or run: source ~/.bashrc");
- }
-} else {
- console.log("✅ SuperClaude already installed.");
-}
-
-// Try to run SuperClaude install
-console.log("\n🚀 Running SuperClaude installation...");
-const installResult = run("SuperClaude", ["install"], { stdio: "inherit" });
-
-if (installResult.status !== 0) {
- console.log("\n⚠️ Could not run 'SuperClaude install' automatically.");
- console.log(" Please run it manually after ensuring SuperClaude is in your PATH:");
- console.log(" SuperClaude install");
-
- if (installMethod === "pipx") {
- console.log("\n If command not found, try:");
- console.log(" pipx ensurepath && source ~/.bashrc");
- } else if (installMethod === "pip-user") {
- console.log("\n If command not found, add Python user bin to PATH:");
- console.log(" export PATH=\"$HOME/.local/bin:$PATH\"");
- }
-}
\ No newline at end of file
diff --git a/bin/update.js b/bin/update.js
deleted file mode 100644
index 7ac5496..0000000
--- a/bin/update.js
+++ /dev/null
@@ -1,71 +0,0 @@
-#!/usr/bin/env node
-const { run, detectPip, detectPipx, isSuperClaudeInstalledPipx, checkPythonEnvironment } = require("./check_env");
-
-console.log("🔄 Checking for SuperClaude updates...");
-
-// Detect installation method
-const isExternallyManaged = checkPythonEnvironment();
-let updateMethod = null;
-
-// Check if installed via pipx
-if (detectPipx() && isSuperClaudeInstalledPipx()) {
- updateMethod = "pipx";
- console.log("✅ Detected pipx installation");
-} else {
- // Check for pip installation
- let pipCmd = detectPip();
- if (!pipCmd) {
- console.error("❌ Neither pipx nor pip found, cannot update.");
- console.error(" Please install SuperClaude first using:");
- console.error(" pipx install SuperClaude");
- console.error(" or");
- console.error(" pip install SuperClaude");
- process.exit(1);
- }
-
- if (isExternallyManaged) {
- updateMethod = "pip-user";
- console.log("✅ Detected pip installation with --user flag");
- } else {
- updateMethod = "pip";
- console.log("✅ Detected standard pip installation");
- }
-}
-
-// Perform update based on detected method
-console.log("🔄 Updating SuperClaude from PyPI...");
-
-let result;
-switch(updateMethod) {
- case "pipx":
- result = run("pipx", ["upgrade", "SuperClaude"], { stdio: "inherit" });
- break;
- case "pip-user":
- result = run(detectPip(), ["install", "--upgrade", "--user", "SuperClaude"], { stdio: "inherit" });
- break;
- case "pip":
- result = run(detectPip(), ["install", "--upgrade", "SuperClaude"], { stdio: "inherit" });
- break;
-}
-
-if (result.status !== 0) {
- console.error("❌ Update failed.");
- if (updateMethod === "pip" && isExternallyManaged) {
- console.error(" Your system requires pipx or --user flag for pip operations.");
- console.error(" Try: pipx upgrade SuperClaude");
- console.error(" Or: pip install --upgrade --user SuperClaude");
- }
- process.exit(1);
-}
-
-console.log("✅ SuperClaude updated successfully!");
-
-// Run SuperClaude update command
-console.log("\n🚀 Running SuperClaude update...");
-const updateResult = run("SuperClaude", ["update"], { stdio: "inherit" });
-
-if (updateResult.status !== 0) {
- console.log("\n⚠️ Could not run 'SuperClaude update' automatically.");
- console.log(" Please run it manually:");
- console.log(" SuperClaude update");
-}
\ No newline at end of file
|