aiw 0.5.21

AIW (AI Warden) - Universal AI CLI management platform with intelligent process tracking, semantic memory, and provider coordination.
Documentation

AIW - AI Workflow Orchestration Tool

Version Rust License MCP

Universal AI CLI Management Platform with Intelligent MCP Routing

AIW is an intelligent platform for managing AI CLI tools (Claude, Codex, Gemini) with MCP routing, process tracking, and configuration synchronization.

🎯 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.)
  • Capability Detection: Auto-detect installed AI CLI tools
  • Wait Mode: Block until AI CLI tasks complete
# Launch AI CLI with process tracking
aiw claude "explain this code"
aiw codex "write a python script"
aiw gemini "translate to french"

# Wait for all AI CLI tasks to complete
aiw wait

# Manage providers
aiw provider list
aiw provider add openrouter "sk-xxx"

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
# 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 ⭐

Route user requests to the best MCP tool with 98% token reduction.

How it works:

  • LLM ReAct Mode: Uses LLM reasoning to analyze requests
  • Vector Search Mode: Semantic similarity fallback
  • Dynamic Registration: Registers tools on-demand (98% token savings)
  • JavaScript Orchestration: Auto-generates workflows for complex tasks

Usage:

# Start MCP server
aiw mcp

# Configure in Claude Code (~/.claude/settings.json)
{
  "mcpServers": {
    "aiw": {
      "command": "aiw",
      "args": ["mcp"]
    }
  }
}

# Available MCP tools:
# - intelligent_route: Auto-route to best tool
# - get_method_schema: Get tool schemas
# - execute_tool: Execute tools with negotiation

3. MCP Server Management

Manage external MCP servers with hot-reload support.

# Add MCP server
aiw mcp add filesystem npx --description "File operations" \
  -- -y @modelcontextprotocol/server-filesystem /home/user

# List servers
aiw mcp list

# Enable/disable servers
aiw mcp enable brave-search
aiw mcp disable filesystem

# Hot-reload: Changes apply instantly without restart

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)
# 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:

  • 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

πŸš€ Quick Start

Installation

# Install from NPM
npm install -g @putao520/aiw

# Or use npx directly
npx @putao520/aiw --help

Initial Setup

# Verify installation
aiw --version

# Check available AI CLI tools
aiw status

# Configure MCP servers
aiw mcp add filesystem npx -- -y @modelcontextprotocol/server-filesystem $HOME

πŸ“– Documentation

πŸ› οΈ Configuration

Environment Variables

# AI CLI Configuration
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

Configuration Files

  • 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

πŸ™ Acknowledgments

πŸ“œ License

MIT License - see LICENSE file for details.

AIW - Universal AI CLI Management Platform with MCP Routing v0.5.21

For full documentation and source code, visit: https://github.com/putao520/agentic-warden