@cliangdev/flux-plugin 0.0.0-dev.b40f7c2 → 0.0.0-dev.cf5e864

package/README.md

@@ -4,30 +4,29 @@ Agent-orchestrated, spec-driven workflow for Claude Code.
 
 ## Installation
 
-### Quick Install (Recommended)
-
 ```bash
-claude mcp add flux -- npx -y @cliangdev/flux-plugin
+npx @cliangdev/flux-plugin
 ```
 
-### Manual Configuration
-
-Add to your `.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "flux": {
-      "command": "npx",
-      "args": ["-y", "@cliangdev/flux-plugin"],
-      "env": {
-        "FLUX_PROJECT_ROOT": "${CLAUDE_PROJECT_DIR}"
-      }
-    }
-  }
-}
+This installs:
+- Commands (`/flux`, `/flux:prd`, `/flux:breakdown`, `/flux:implement`)
+- Skills for AI orchestration
+- MCP server for project data
+
+### Options
+
+```bash
+npx @cliangdev/flux-plugin --global   # Install to ~/.claude (all projects)
+npx @cliangdev/flux-plugin --local    # Install to ./.claude (current project)
 ```
 
+### What Gets Configured
+
+The installer automatically:
+1. Copies commands to `.claude/commands/`
+2. Copies skills to `.claude/skills/`
+3. Adds MCP server config to `.claude.json`
+
 ## Commands
 
 | Command | Purpose |
@@ -119,13 +118,47 @@ your-project/
 
 ## Updating
 
-The plugin auto-updates via npx. Restart Claude Code to get the latest version.
+To update to the latest version, simply re-run the installer:
 
-Check your version:
+```bash
+npx @cliangdev/flux-plugin@latest --global
+```
+
+This will:
+- Update commands and skills to the latest version
+- Update the MCP server configuration
+
+Check your current version:
 ```
 /flux version
 ```
 
+## Uninstall
+
+### Global Installation
+
+```bash
+# Remove commands and skills
+rm -rf ~/.claude/commands/flux ~/.claude/commands/prd ~/.claude/commands/breakdown ~/.claude/commands/implement
+rm -rf ~/.claude/skills/agent-creator ~/.claude/skills/epic-template ~/.claude/skills/flux-orchestrator ~/.claude/skills/prd-template
+rm -f ~/.claude/flux-version
+
+# Remove MCP server config (edit ~/.claude.json and remove the "flux" entry from "mcpServers")
+```
+
+### Local Installation
+
+```bash
+# Remove commands and skills
+rm -rf .claude/commands/flux .claude/commands/prd .claude/commands/breakdown .claude/commands/implement
+rm -rf .claude/skills/agent-creator .claude/skills/epic-template .claude/skills/flux-orchestrator .claude/skills/prd-template
+rm -f .claude/flux-version
+
+# Remove MCP server config (edit .claude.json and remove the "flux" entry from "mcpServers")
+```
+
+Note: Your project data in `.flux/` is preserved. Delete it manually if you want to remove all Flux data.
+
 ## Support
 
 GitHub: [github.com/cliangdev/flux-plugin](https://github.com/cliangdev/flux-plugin)

package/bin/install.cjs

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const readline = require("readline");
+
+// Parse args first to check for serve command
+const args = process.argv.slice(2);
+
+// Check for "serve" subcommand - starts MCP server
+if (args[0] === "serve") {
+	// Dynamic import to load ESM server
+	import("../dist/server/index.js").catch((err) => {
+		console.error("Failed to start Flux MCP server:", err.message);
+		process.exit(1);
+	});
+} else {
+	// Run installer
+	runInstaller();
+}
+
+function runInstaller() {
+	// Colors
+	const cyan = "\x1b[36m";
+	const green = "\x1b[32m";
+	const yellow = "\x1b[33m";
+	const dim = "\x1b[2m";
+	const reset = "\x1b[0m";
+
+	// Get version from package.json
+	const pkg = require("../package.json");
+
+	const banner = `
+${cyan}  ███████╗██╗     ██╗   ██╗██╗  ██╗
+  ██╔════╝██║     ██║   ██║╚██╗██╔╝
+  █████╗  ██║     ██║   ██║ ╚███╔╝
+  ██╔══╝  ██║     ██║   ██║ ██╔██╗
+  ██║     ███████╗╚██████╔╝██╔╝ ██╗
+  ╚═╝     ╚══════╝ ╚═════╝ ╚═╝  ╚═╝${reset}
+
+  Flux Plugin ${dim}v${pkg.version}${reset}
+  AI-first workflow orchestration for Claude Code
+`;
+
+	const hasGlobal = args.includes("--global") || args.includes("-g");
+	const hasLocal = args.includes("--local") || args.includes("-l");
+	const hasHelp = args.includes("--help") || args.includes("-h");
+
+	console.log(banner);
+
+	// Show help
+	if (hasHelp) {
+		console.log(`  ${yellow}Usage:${reset} npx @cliangdev/flux-plugin [options]
+
+  ${yellow}Options:${reset}
+    ${cyan}-g, --global${reset}    Install globally (to ~/.claude)
+    ${cyan}-l, --local${reset}     Install locally (to ./.claude in current directory)
+    ${cyan}-h, --help${reset}      Show this help message
+
+  ${yellow}Examples:${reset}
+    ${dim}# Interactive installation${reset}
+    npx @cliangdev/flux-plugin
+
+    ${dim}# Install globally (all projects)${reset}
+    npx @cliangdev/flux-plugin --global
+
+    ${dim}# Install locally (current project only)${reset}
+    npx @cliangdev/flux-plugin --local
+`);
+		process.exit(0);
+	}
+
+	/**
+	 * Recursively copy directory
+	 */
+	function copyDir(src, dest) {
+		fs.mkdirSync(dest, { recursive: true });
+		const entries = fs.readdirSync(src, { withFileTypes: true });
+
+		for (const entry of entries) {
+			const srcPath = path.join(src, entry.name);
+			const destPath = path.join(dest, entry.name);
+
+			if (entry.isDirectory()) {
+				copyDir(srcPath, destPath);
+			} else {
+				fs.copyFileSync(srcPath, destPath);
+			}
+		}
+	}
+
+	/**
+	 * Read JSON file, return empty object if doesn't exist
+	 */
+	function readJson(filePath) {
+		if (fs.existsSync(filePath)) {
+			try {
+				return JSON.parse(fs.readFileSync(filePath, "utf8"));
+			} catch {
+				return {};
+			}
+		}
+		return {};
+	}
+
+	/**
+	 * Write JSON file with formatting
+	 */
+	function writeJson(filePath, data) {
+		fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
+	}
+
+	/**
+	 * Install to specified directory
+	 */
+	function install(isGlobal) {
+		const src = path.join(__dirname, "..");
+		const claudeDir = isGlobal
+			? path.join(os.homedir(), ".claude")
+			: path.join(process.cwd(), ".claude");
+
+		const locationLabel = isGlobal ? "~/.claude" : "./.claude";
+
+		console.log(`  Installing to ${cyan}${locationLabel}${reset}\n`);
+
+		// Create directories
+		fs.mkdirSync(claudeDir, { recursive: true });
+
+		// Copy commands
+		const commandsSrc = path.join(src, "commands");
+		if (fs.existsSync(commandsSrc)) {
+			const commandsDest = path.join(claudeDir, "commands");
+			fs.mkdirSync(commandsDest, { recursive: true });
+
+			// Copy each command as a directory (flux.md -> commands/flux/COMMAND.md)
+			const commandFiles = fs.readdirSync(commandsSrc);
+			for (const file of commandFiles) {
+				if (file.endsWith(".md")) {
+					const name = file.replace(".md", "");
+					const destDir = path.join(commandsDest, name);
+					fs.mkdirSync(destDir, { recursive: true });
+					fs.copyFileSync(
+						path.join(commandsSrc, file),
+						path.join(destDir, "COMMAND.md")
+					);
+					console.log(`  ${green}✓${reset} Installed command: /${name}`);
+				}
+			}
+		}
+
+		// Copy skills
+		const skillsSrc = path.join(src, "skills");
+		if (fs.existsSync(skillsSrc)) {
+			const skillsDest = path.join(claudeDir, "skills");
+			fs.mkdirSync(skillsDest, { recursive: true });
+
+			// Copy each skill directory
+			const skillDirs = fs.readdirSync(skillsSrc, { withFileTypes: true });
+			for (const dir of skillDirs) {
+				if (dir.isDirectory()) {
+					copyDir(
+						path.join(skillsSrc, dir.name),
+						path.join(skillsDest, dir.name)
+					);
+					console.log(`  ${green}✓${reset} Installed skill: ${dir.name}`);
+				}
+			}
+		}
+
+		// Configure MCP server
+		const claudeJsonPath = isGlobal
+			? path.join(os.homedir(), ".claude.json")
+			: path.join(process.cwd(), ".claude.json");
+
+		const claudeJson = readJson(claudeJsonPath);
+
+		if (!claudeJson.mcpServers) {
+			claudeJson.mcpServers = {};
+		}
+
+		// Add or update flux MCP server
+		claudeJson.mcpServers.flux = {
+			command: "npx",
+			args: ["-y", "@cliangdev/flux-plugin", "serve"],
+		};
+
+		writeJson(claudeJsonPath, claudeJson);
+		console.log(
+			`  ${green}✓${reset} Configured MCP server in ${isGlobal ? "~/.claude.json" : "./.claude.json"}`
+		);
+
+		// Write version file for update checking
+		const versionFile = path.join(claudeDir, "flux-version");
+		fs.writeFileSync(versionFile, pkg.version);
+
+		console.log(`
+  ${green}Done!${reset} Restart Claude Code and run ${cyan}/flux${reset} to get started.
+
+  ${dim}Commands available:${reset}
+    /flux           - Project status and guidance
+    /flux:prd       - Create or refine PRDs
+    /flux:breakdown - Break PRDs into epics and tasks
+    /flux:implement - Implement tasks with TDD
+
+  ${dim}Learn more:${reset} https://github.com/cliangdev/flux-plugin
+`);
+	}
+
+	/**
+	 * Prompt for install location
+	 */
+	function promptLocation() {
+		const rl = readline.createInterface({
+			input: process.stdin,
+			output: process.stdout,
+		});
+
+		console.log(`  ${yellow}Where would you like to install?${reset}
+
+  ${cyan}1${reset}) Global ${dim}(~/.claude)${reset} - available in all projects
+  ${cyan}2${reset}) Local  ${dim}(./.claude)${reset} - this project only
+`);
+
+		rl.question(`  Choice ${dim}[1]${reset}: `, (answer) => {
+			rl.close();
+			const choice = answer.trim() || "1";
+			install(choice !== "2");
+		});
+	}
+
+	// Main
+	if (hasGlobal && hasLocal) {
+		console.error(`  ${yellow}Cannot specify both --global and --local${reset}`);
+		process.exit(1);
+	} else if (hasGlobal) {
+		install(true);
+	} else if (hasLocal) {
+		install(false);
+	} else {
+		promptLocation();
+	}
+}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@cliangdev/flux-plugin",
-  "version": "0.0.0-dev.b40f7c2",
+  "version": "0.0.0-dev.cf5e864",
   "description": "Claude Code plugin for AI-first workflow orchestration with MCP server",
   "type": "module",
   "main": "./dist/server/index.js",
   "bin": {
-    "flux-plugin": "./dist/server/index.js"
+    "flux-plugin": "./bin/install.cjs"
   },
   "files": [
+    "bin/",
     "dist/",
     "skills/",
     "commands/"