aiw 0.5.25

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 & Transparent Parameter Forwarding

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

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

๐Ÿ”„ 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

# 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

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

# Tool restrictions
aiw claude -p glm --allowed-tools Bash,Edit --print "modify this file"

# Multiple parameters
aiw claude -p glm --model sonnet --max-budget-usd 5 --dangerously-skip-permissions "help me debug"

Interactive Mode

# 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

# 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

# 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.22

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