@putao520/aiw 0.5.14 → 0.5.26

package/README.md

@@ -2,37 +2,61 @@
 
 <div align="center">
 
-![Version](https://img.shields.io/badge/version-0.5.13-blue?style=flat-square)
+![Version](https://img.shields.io/badge/version-0.5.25--developing-blue?style=flat-square)
 ![Rust](https://img.shields.io/badge/Rust-1.70+-orange?style=flat-square&logo=rust)
 ![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)
 ![MCP](https://img.shields.io/badge/MCP-Supported-purple?style=flat-square)
 
-**Universal AI CLI Management Platform with Intelligent MCP Routing**
+**Universal AI CLI Management Platform with Intelligent MCP Routing & Transparent Parameter Forwarding**
 
 </div>
 
-AIW is an intelligent platform for managing AI CLI tools (Claude, Codex, Gemini) with MCP routing, process tracking, and configuration synchronization.
+AIW is an intelligent platform for managing AI CLI tools (Claude, Codex, Gemini) with MCP routing, process tracking, provider management, and transparent parameter forwarding.
 
 ## 🎯 Core Features
 
 ### 1. AI CLI Management
 - **Process Tree Tracking**: Monitor AI CLI processes and their children
 - **Provider Management**: Switch between AI providers (OpenAI, Anthropic, Google, etc.)
+- **Transparent Parameter Forwarding**: Seamlessly pass all CLI parameters while using provider management
 - **Capability Detection**: Auto-detect installed AI CLI tools
 - **Wait Mode**: Block until AI CLI tasks complete
 
 ```bash
-# Launch AI CLI with process tracking
-aiw claude "explain this code"
-aiw codex "write a python script"
-aiw gemini "translate to french"
+# Basic usage with provider management
+aiw claude "explain this code"                              # Use default provider
+aiw claude -p openrouter "explain this code"                 # Use OpenRouter provider
+aiw claude -p glm "解释这段代码"                              # Use custom GLM provider
+
+# 🆕 Transparent Parameter Forwarding (v0.5.23+)
+aiw claude -p glm --model sonnet --debug api "explain this code"
+aiw claude -p glm --print --output-format json "get structured response"
+aiw codex -p glm --temperature 0.7 --max-tokens 1000 "generate text"
+
+# Interactive mode with parameter forwarding
+aiw claude -p glm --model sonnet --debug api               # Interactive session with custom parameters
+aiw claude -p glm --print --allowed-tools Bash,Edit         # Interactive with tool restrictions
 
 # Wait for all AI CLI tasks to complete
-aiw wait --timeout 300
+aiw wait
 
-# Manage providers
-aiw provider list
-aiw provider add openrouter "sk-xxx"
+# Manage providers (TUI interface)
+aiw provider
+```
+
+### 5. Update (更新AIW和AI CLI工具)
+- **AIW Self-Update**: Update AIW itself to latest version from NPM
+- **AI CLI Tools Update**: Update all installed AI CLI tools (claude, codex, gemini)
+- **Combined Update**: Update both AIW and AI CLI tools in one command
+
+```bash
+# Update both AIW and all AI CLI tools
+aiw update
+
+# Command will:
+# 1. Check and update AIW to latest version
+# 2. Check and update all installed AI CLI tools
+# 3. Show detailed results for both updates
 ```
 
 ### 2. Intelligent MCP Routing ⭐
@@ -49,7 +73,7 @@ Route user requests to the best MCP tool with 98% token reduction.
 # Start MCP server
 aiw mcp
 
-# Configure in Claude Code (~/.config/claude-code/mcp.json)
+# Configure in Claude Code (~/.claude/settings.json)
 {
   "mcpServers": {
     "aiw": {
@@ -83,20 +107,190 @@ aiw mcp disable filesystem
 # Hot-reload: Changes apply instantly without restart
 ```
 
-### 4. Google Drive Sync (Optional)
-Synchronize AI CLI configurations across devices using Google Drive.
+### 4. MCP Registry CLI ⭐
+Search and install MCP servers from multiple registries with multi-source aggregation.
+
+**Supported Registries:**
+- **Official MCP Registry** (registry.modelcontextprotocol.io)
+- **Smithery** (registry.smithery.ai)
+
+```bash
+# Interactive browse all MCP servers (with fuzzy search)
+aiw mcp browse
+
+# Search MCP servers across all registries
+aiw mcp search "filesystem"
+aiw mcp search "git" --source official  # Search specific registry
+
+# Get detailed server information
+aiw mcp info @anthropic/filesystem
+
+# Install MCP server with interactive setup
+aiw mcp install @anthropic/filesystem
+
+# Install with environment variables
+aiw mcp install @anthropic/filesystem --env API_KEY=xxx
+
+# Update registry cache
+aiw mcp update
+```
+
+**Features:**
+- **Interactive Browse**: Fuzzy search through all servers with ↑↓ navigation
+- **Multi-source Aggregation**: Search across Official Registry + Smithery in parallel
+- **Deduplication**: Same server from multiple sources shown once with best match
+- **Interactive Install**: Configure environment variables during installation
+- **Source Tracking**: Track where each server was installed from
+
+### 5. Plugin Marketplace ⭐
+Browse and install plugins from Claude Code-compatible plugin marketplaces.
+
+**Default Marketplaces:**
+- **Claude Code Official** (anthropics/claude-plugins-official)
+- **AIW Official** (putao520/aiw-plugins)
+
+```bash
+# Browse MCP plugins interactively
+aiw plugin browse
+
+# Search plugins
+aiw plugin search "git"
+aiw plugin search "playwright" --market claude-code-official
+
+# View plugin details
+aiw plugin info playwright@claude-code-official
+
+# Install plugin (interactive setup)
+aiw plugin install playwright@claude-code-official
+
+# Install with environment variables
+aiw plugin install serena@claude-code-official --env MY_VAR=value
+
+# List installed plugins
+aiw plugin list
+
+# Enable/disable plugins
+aiw plugin enable playwright
+aiw plugin disable serena
+
+# Remove plugin
+aiw plugin remove playwright
+```
+
+**Marketplace Management:**
+```bash
+# List marketplaces
+aiw plugin marketplace list
+
+# Add custom marketplace
+aiw plugin marketplace add my-market https://github.com/user/marketplace
+
+# Remove marketplace
+aiw plugin marketplace remove my-market
+
+# Update marketplace indexes
+aiw plugin marketplace update
+```
+
+**Configuration Files:**
+- `~/.aiw/settings.json`: Marketplace sources and plugin states
+- `~/.aiw/plugins.json`: Installed plugin records
+- `~/.aiw/mcp.json`: Extracted MCP server configurations
+
+**Features:**
+- **MCP-Only Filtering**: Only shows plugins with MCP servers (mcpServers field)
+- **Claude Code Compatible**: Uses same plugin format as Claude Code
+- **JSON Configuration**: Modern JSON format (automatic YAML migration)
+- **Interactive Setup**: Configure environment variables during installation
+- **Hot-Reload**: Changes apply instantly without restart
+- **Transport Type Support**: Supports stdio transport (local executables). HTTP/SSE transports coming soon.
+
+**Environment Variables:**
+Plugins can use environment variable placeholders in their MCP configuration:
+```json
+{
+  "env": {
+    "API_KEY": "${API_KEY}",
+    "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+  }
+}
+```
+During installation, AIW will prompt for values or you can provide them via `--env` flag. Placeholders are preserved in the config and expanded at runtime.
+
+## 🔄 Transparent Parameter Forwarding (v0.5.23+)
+
+AIW now supports transparent parameter forwarding, allowing you to use **all** AI CLI features while maintaining provider management capabilities.
 
+### How It Works
+
+```bash
+# Parameter parsing logic:
+aiw <ai_type> -p <provider> <cli_params...> <prompt>
+#           ^^^^^^^^  ^^^^^^^^^^^  ^^^^^^^^^^^^^^^^^^^^
+#           AIW处理     AIW处理        透明转发到AI CLI
+```
+
+### Rules
+
+- **AIW Consumes**: `-p` / `--provider` parameters for provider selection
+- **Transparent Forwarding**: All other `-` prefixed parameters are passed directly to the AI CLI
+- **Parameter Order**: Provider flags must come **before** other CLI parameters
+- **Full Compatibility**: Maintain complete access to all AI CLI features
+
+### Examples
+
+#### Task Mode
 ```bash
-# Push configurations to Google Drive
-aiw push [config_name]
+# Model selection with debugging
+aiw claude -p glm --model sonnet --debug api "explain this code"
+
+# Structured output
+aiw claude -p glm --print --output-format json "summarize the file"
 
-# Pull configurations from Google Drive
-aiw pull [config_name]
+# Tool restrictions
+aiw claude -p glm --allowed-tools Bash,Edit --print "modify this file"
 
-# List available backups
-aiw list
+# Multiple parameters
+aiw claude -p glm --model sonnet --max-budget-usd 5 --dangerously-skip-permissions "help me debug"
 ```
 
+#### Interactive Mode
+```bash
+# Interactive session with custom model and debugging
+aiw claude -p glm --model sonnet --debug api
+
+# Interactive with output formatting
+aiw claude -p glm --print --output-format stream-json
+
+# Interactive with specific tools
+aiw claude -p glm --tools "Bash,Edit,Read" --no-session-persistence
+
+# Multi-AI with same provider and parameters
+aiw claude,codex -p glm --temperature 0.7 --print "compare approaches"
+```
+
+#### Provider-Specific Examples
+```bash
+# Claude with structured output
+aiw claude -p glm --json-schema '{"type":"object","properties":{"summary":{"type":"string"}}}' --print "summarize"
+
+# Codex with custom settings
+aiw codex -p glm --temperature 0.3 --max-tokens 500 "write python function"
+
+# Gemini with approval mode
+aiw gemini -p glm --approval-mode yolo --print "translate this text"
+```
+
+### Benefits
+
+✅ **Full CLI Access**: Use all AI CLI parameters without limitations
+✅ **Provider Flexibility**: Switch providers without changing commands
+✅ **Process Tracking**: Maintain AIW's monitoring and task management
+✅ **Environment Injection**: Automatic provider configuration injection
+✅ **Zero Learning Curve**: Works exactly like native AI CLI with provider prefix
+
+---
+
 ## 🚀 Quick Start
 
 ### Installation
@@ -134,17 +328,13 @@ export CLI_TYPE=claude              # claude, codex, or gemini
 export CLI_PROVIDER=llmlite         # Any provider from provider.json
 
 # MCP Server Configuration
-export MCP_CONFIG_PATH=~/.aiw/.mcp.json
-
-# Google Drive OAuth (optional)
-export GOOGLE_CLIENT_ID=xxx
-export GOOGLE_CLIENT_SECRET=xxx
+export MCP_CONFIG_PATH=~/.aiw/mcp.json
 ```
 
 ### Configuration Files
-- **MCP Servers**: `~/.aiw/.mcp.json`
+- **MCP Servers**: `~/.aiw/mcp.json` (standard `mcpServers` schema compatible with Claude Code)
+  - Claude Code users: Add to `~/.claude/settings.json` under the "mcpServers" section
 - **Providers**: `~/.aiw/providers.json`
-- **Google Drive Auth**: `~/.aiw/auth.json`
 
 ## 🙏 Acknowledgments
 
@@ -157,6 +347,6 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ---
 
-**AIW** - Universal AI CLI Management Platform with MCP Routing v0.5.13
+**AIW** - Universal AI CLI Management Platform with MCP Routing v0.5.25
 
-For full documentation and source code, visit: [https://github.com/putao520/agentic-warden](https://github.com/putao520/agentic-warden)
+For full documentation and source code, visit: [https://github.com/putao520/agentic-warden](https://github.com/putao520/agentic-warden)

package/index.js

@@ -3,39 +3,48 @@
 const { spawnSync } = require('child_process');
 const path = require('path');
 const os = require('os');
+const fs = require('fs');
 
-// 根据架构选择正确的二进制
 const arch = os.arch();
 const platform = os.platform();
 
+let binaryName;
 let binaryPath;
 
-if (platform === 'linux') {
-  switch (arch) {
-    case 'x64':
-      binaryPath = path.join(__dirname, 'bin', 'aiw-linux-x64');
-      break;
-    default:
-      console.error(`❌ Unsupported architecture: ${arch}`);
-      console.error('Supported: x64');
-      process.exit(1);
-  }
-} else if (platform === 'win32') {
-  switch (arch) {
-    case 'x64':
-      binaryPath = path.join(__dirname, 'bin', 'aiw-windows-x64.exe');
-      break;
-    default:
-      console.error(`❌ Unsupported architecture: ${arch}`);
-      console.error('Supported: x64');
-      process.exit(1);
-  }
+// Determine binary name based on platform
+if (platform === 'linux' && arch === 'x64') {
+  binaryName = 'aiw-linux-x64';
+} else if (platform === 'win32' && arch === 'x64') {
+  binaryName = 'aiw-windows-x64.exe';
 } else {
-  console.error(`❌ Unsupported platform: ${platform}`);
-  console.error('Supported: linux, win32');
-  console.error('\nAlternative options:');
-  console.error('1. Using Cargo: cargo install --git https://github.com/putao520/agentic-warden');
-  console.error('2. Download pre-built: https://github.com/putao520/agentic-warden/releases');
+  console.error(`Error: Unsupported platform: ${platform}-${arch}`);
+  console.error('');
+  console.error('Supported platforms:');
+  console.error('  - linux-x64');
+  console.error('  - win32-x64');
+  console.error('');
+  console.error('Alternative installation:');
+  console.error('  cargo install --git https://github.com/putao520/agentic-warden');
+  console.error('  https://github.com/putao520/agentic-warden/releases');
+  process.exit(1);
+}
+
+binaryPath = path.join(__dirname, 'bin', binaryName);
+
+// Check if binary exists
+if (!fs.existsSync(binaryPath)) {
+  console.error(`Error: Binary not found: ${binaryPath}`);
+  console.error('');
+  console.error('The postinstall script may have failed to download the binary.');
+  console.error('');
+  console.error('Try reinstalling:');
+  console.error('  npm uninstall -g @putao520/aiw && npm install -g @putao520/aiw');
+  console.error('');
+  console.error('Or run postinstall manually:');
+  console.error(`  node ${path.join(__dirname, 'scripts', 'postinstall.js')}`);
+  console.error('');
+  console.error('Alternative installation:');
+  console.error('  cargo install --git https://github.com/putao520/agentic-warden');
   process.exit(1);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@putao520/aiw",
-  "version": "0.5.14",
+  "version": "0.5.26",
   "description": "Universal AI CLI management platform with intelligent MCP routing, process tracking, and configuration synchronization",
   "keywords": [
     "ai",
@@ -23,12 +23,14 @@
   "license": "MIT",
   "author": "Putao520",
   "bin": {
-    "aiw": "./bin/aiw-linux-x64"
+    "aiw": "./index.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
   },
   "files": [
-    "bin/aiw-linux-x64",
-    "bin/aiw-windows-x64.exe",
     "index.js",
+    "scripts/postinstall.js",
     "README.md"
   ],
   "engines": {
@@ -39,16 +41,13 @@
     "win32"
   ],
   "cpu": [
-    "x64",
-    "arm64",
-    "arm"
+    "x64"
   ],
   "bugs": {
     "url": "https://github.com/putao520/agentic-warden/issues"
   },
   "publishConfig": {
     "access": "public",
-    "registry": "https://registry.npmjs.org/",
-    "provenance": true
+    "registry": "https://registry.npmjs.org/"
   }
 }

package/scripts/README.md

@@ -0,0 +1,60 @@
+# 脚本使用说明
+
+## 版本更新脚本 (update-version.sh)
+
+### 功能
+自动化同步项目版本号，确保所有文件保持一致。
+
+### 更新的文件
+- `VERSION` - 项目主版本文件
+- `Cargo.toml` - Rust 项目版本
+- `npm-package/package.json` - 由 GitHub Actions 自动更新
+
+### 使用方法
+
+```bash
+# 基本用法
+./scripts/update-version.sh <version>
+
+# 示例：更新到版本 0.5.20
+./scripts/update-version.sh 0.5.20
+```
+
+### 版本格式
+必须使用 `major.minor.patch` 格式：
+- ✅ `0.5.20`
+- ✅ `1.0.0`
+- ❌ `v0.5.20` (不要加 v)
+- ❌ `0.5` (不完整)
+
+### 完整工作流程
+
+```bash
+# 1. 运行脚本更新版本
+./scripts/update-version.sh 0.5.20
+
+# 2. 检查变更
+git diff
+
+# 3. 提交变更
+git add .
+git commit -m "feat: 版本更新到 0.5.20"
+
+# 4. 创建并推送 tag
+git tag v0.5.20
+git push origin master
+git push origin v0.5.20
+
+# 5. GitHub Actions 将自动:
+#    - 构建 Linux 和 Windows 二进制文件
+#    - 更新 npm-package/package.json 版本
+#    - 发布到 NPM
+#    - 创建 GitHub Release
+```
+
+### 注意事项
+
+1. **npm-package/package.json 由 CI/CD 自动更新**，无需手动修改
+2. **版本号必须与 Git tag 保持一致**
+3. **脚本会验证版本格式，不符合会报错**
+4. **每次更新前会检查文件是否存在，避免误操作**

package/scripts/postinstall.js

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall.js - Platform-specific binary downloader for aiw
+ *
+ * Downloads the correct binary for the current platform from GitHub Releases.
+ * Supports: Linux x64, Windows x64
+ */
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// Configuration
+const REPO_OWNER = 'putao520';
+const REPO_NAME = 'agentic-warden';
+const BIN_DIR = path.join(__dirname, '..', 'bin');
+
+// Platform mapping
+const PLATFORM_MAP = {
+  'linux-x64': {
+    filename: 'aiw-linux-x64',
+    asset: 'aiw-linux-x64',
+  },
+  'win32-x64': {
+    filename: 'aiw-windows-x64.exe',
+    asset: 'aiw-windows-x64.exe',
+  },
+};
+
+/**
+ * Get package version from package.json
+ */
+function getPackageVersion() {
+  const packageJson = require(path.join(__dirname, '..', 'package.json'));
+  return packageJson.version;
+}
+
+/**
+ * Get platform key for current system
+ */
+function getPlatformKey() {
+  const platform = os.platform();
+  const arch = os.arch();
+  return `${platform}-${arch}`;
+}
+
+/**
+ * Download file with redirect support
+ */
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+
+    const request = (url) => {
+      const protocol = url.startsWith('https') ? https : require('http');
+
+      protocol.get(url, {
+        headers: {
+          'User-Agent': 'aiw-npm-installer',
+        },
+      }, (response) => {
+        // Handle redirects (GitHub releases use 302)
+        if (response.statusCode === 301 || response.statusCode === 302) {
+          const redirectUrl = response.headers.location;
+          if (redirectUrl) {
+            request(redirectUrl);
+            return;
+          }
+        }
+
+        if (response.statusCode !== 200) {
+          reject(new Error(`Download failed with status ${response.statusCode}`));
+          return;
+        }
+
+        const totalSize = parseInt(response.headers['content-length'], 10);
+        let downloadedSize = 0;
+        let lastProgress = 0;
+
+        response.on('data', (chunk) => {
+          downloadedSize += chunk.length;
+          if (totalSize) {
+            const progress = Math.floor((downloadedSize / totalSize) * 100);
+            if (progress >= lastProgress + 10) {
+              process.stdout.write(`\r  Downloading: ${progress}%`);
+              lastProgress = progress;
+            }
+          }
+        });
+
+        response.pipe(file);
+
+        file.on('finish', () => {
+          file.close();
+          console.log('\r  Downloading: 100%');
+          resolve();
+        });
+      }).on('error', (err) => {
+        fs.unlink(dest, () => {});
+        reject(err);
+      });
+    };
+
+    request(url);
+  });
+}
+
+/**
+ * Make file executable (Unix only)
+ */
+function makeExecutable(filepath) {
+  if (os.platform() !== 'win32') {
+    try {
+      fs.chmodSync(filepath, 0o755);
+    } catch (err) {
+      console.warn(`  Warning: Could not set executable permission: ${err.message}`);
+    }
+  }
+}
+
+/**
+ * Check if binary already exists and is valid
+ */
+function binaryExists(filepath) {
+  try {
+    if (!fs.existsSync(filepath)) {
+      return false;
+    }
+
+    // Check if file is executable and returns version
+    const stat = fs.statSync(filepath);
+    if (stat.size < 1000) {
+      // File too small, probably corrupted
+      return false;
+    }
+
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Main installation function
+ */
+async function install() {
+  console.log('');
+  console.log('  aiw postinstall: Setting up platform-specific binary...');
+  console.log('');
+
+  const platformKey = getPlatformKey();
+  const platformInfo = PLATFORM_MAP[platformKey];
+
+  if (!platformInfo) {
+    console.log(`  Platform ${platformKey} is not supported.`);
+    console.log('');
+    console.log('  Supported platforms:');
+    console.log('    - linux-x64');
+    console.log('    - win32-x64');
+    console.log('');
+    console.log('  Alternative installation methods:');
+    console.log('    1. Cargo: cargo install --git https://github.com/putao520/agentic-warden');
+    console.log('    2. Download: https://github.com/putao520/agentic-warden/releases');
+    console.log('');
+    process.exit(0); // Don't fail npm install
+  }
+
+  // Ensure bin directory exists
+  if (!fs.existsSync(BIN_DIR)) {
+    fs.mkdirSync(BIN_DIR, { recursive: true });
+  }
+
+  const binaryPath = path.join(BIN_DIR, platformInfo.filename);
+
+  // Check if binary already exists
+  if (binaryExists(binaryPath)) {
+    console.log(`  Binary already exists: ${platformInfo.filename}`);
+    console.log('  Skipping download.');
+    console.log('');
+    return;
+  }
+
+  const version = getPackageVersion();
+  const downloadUrl = `https://github.com/${REPO_OWNER}/${REPO_NAME}/releases/download/v${version}/${platformInfo.asset}`;
+
+  console.log(`  Platform: ${platformKey}`);
+  console.log(`  Version: v${version}`);
+  console.log(`  Binary: ${platformInfo.filename}`);
+  console.log('');
+
+  try {
+    console.log(`  Downloading from GitHub Releases...`);
+    await downloadFile(downloadUrl, binaryPath);
+
+    makeExecutable(binaryPath);
+
+    console.log('');
+    console.log('  Installation complete!');
+    console.log(`  Binary installed: ${binaryPath}`);
+    console.log('');
+  } catch (err) {
+    console.error('');
+    console.error(`  Download failed: ${err.message}`);
+    console.error('');
+    console.error('  This might happen if:');
+    console.error(`    - Release v${version} doesn't exist yet`);
+    console.error('    - GitHub is unreachable');
+    console.error('    - Network issues');
+    console.error('');
+    console.error('  Alternative installation:');
+    console.error('    cargo install --git https://github.com/putao520/agentic-warden');
+    console.error('');
+
+    // Clean up partial download
+    try {
+      if (fs.existsSync(binaryPath)) {
+        fs.unlinkSync(binaryPath);
+      }
+    } catch {}
+
+    // Don't fail npm install, just warn
+    process.exit(0);
+  }
+}
+
+// Run installation
+install().catch((err) => {
+  console.error('  Unexpected error:', err.message);
+  process.exit(0); // Don't fail npm install
+});