@wundr.io/cli 1.0.0 → 1.0.2-dev.20260530174250.ef0ec927

package/README.md

@@ -1,221 +1,581 @@
-# @wundr/cli
+# @wundr.io/cli
 
-The unified CLI framework for the Wundr platform - Transform monolithic chaos into architectural
-elegance with AI-powered development tools.
+[![npm version](https://badge.fury.io/js/@wundr.io%2Fcli.svg)](https://www.npmjs.com/package/@wundr.io/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
 
-## 🚀 Features
+**From chaos to excellence, systematically.**
 
-- **Commander.js Foundation** - Robust command structure with comprehensive help
-- **Interactive Modes** - Wizard, Chat, TUI, and Watch interfaces
-- **Plugin System** - Extensible architecture with hot-loading
-- **Batch Processing** - YAML-based automation and scripting
-- **AI Integration** - Natural language development assistance
-- **Cross-Platform** - Works on macOS, Linux, and Windows
-- **Real-time Monitoring** - File watching and live updates
-- **Web Dashboard** - Rich visualization and reporting
+The Wundr CLI is the unified command-line interface for the Wundr platform - your all-in-one toolkit
+for developer machine provisioning, project scaffolding, and automated code governance. Built for
+engineering teams who demand consistency, quality, and velocity.
 
-## 📦 Installation
+## What is Wundr CLI?
+
+Wundr CLI is the **crown jewel** of the Wundr platform - a powerful, AI-native developer toolkit
+that transforms how teams:
+
+- **Provision Machines**: Set up new developer workstations in minutes with role-based profiles
+- **Create Projects**: Scaffold production-ready, governance-compliant projects instantly
+- **Enforce Quality**: Automate code analysis, dependency management, and quality gates
+- **Scale Teams**: Ensure consistency across developers, projects, and repositories
+
+Whether you're onboarding new engineers, starting a new project, or maintaining code quality across
+a monorepo, Wundr CLI provides the automation and intelligence you need.
+
+## Core Features
+
+### 1. Computer Setup & Provisioning
+
+Automate the setup of developer workstations with comprehensive tool installations and
+configurations.
+
+**Key Capabilities:**
+
+- 6 pre-configured developer profiles (Frontend, Backend, Full Stack, DevOps, ML, Mobile)
+- Cross-platform support (macOS, Linux, Windows WSL2)
+- Team configuration management
+- Parallel installation with rollback support
+- Validation and health checks
+
+**Example:**
 
 ```bash
-npm install -g @wundr/cli
+# Interactive setup wizard
+wundr computer-setup
+
+# Setup with specific profile
+wundr computer-setup --profile fullstack
+
+# Apply team configuration
+wundr computer-setup --team platform-engineering
+
+# Validate current setup
+wundr computer-setup validate
 ```
 
-Or use with npx:
+### 2. Project Creation & Scaffolding
+
+Create production-ready, Wundr-compliant projects with best practices built-in.
+
+**Key Capabilities:**
+
+- Multiple project templates (Next.js, Node.js, React, TypeScript libraries)
+- Component and service generators
+- Automatic governance configuration
+- Monorepo support
+- Custom template system
+
+**Example:**
 
 ```bash
-npx @wundr/cli --help
+# Interactive project creation
+wundr create project
+
+# Create with specific template
+wundr create project nextjs my-app --typescript
+
+# Create component
+wundr create component Button --type react
+
+# Create service
+wundr create service auth --template microservice
 ```
 
-## 🎯 Quick Start
+### 3. Code Governance & Quality
+
+Automated code analysis, dependency management, and quality enforcement.
+
+**Key Capabilities:**
 
-### Initialize a new project
+- Dependency analysis (circular, unused, outdated, security)
+- Code quality metrics and drift detection
+- Automated pattern standardization
+- Compliance reporting
+- Real-time monitoring
+
+**Example:**
 
 ```bash
-wundr init project my-app
-wundr init config --interactive
+# Analyze dependencies
+wundr analyze deps --circular --security
+
+# Check code quality
+wundr analyze quality --path ./src
+
+# Detect code drift
+wundr analyze drift
+
+# Generate compliance report
+wundr govern report --weekly
+```
+
+## Quick Start
+
+### Installation
+
+Install globally via npm:
+
+```bash
+npm install -g @wundr.io/cli
+```
+
+Or use with npx (no installation required):
+
+```bash
+npx @wundr.io/cli --help
 ```
 
-### Launch interactive wizard
+### First Command
+
+Run the interactive wizard to get started:
 
 ```bash
 wundr wizard
-# or
-wundr w
 ```
 
-### Analyze your code
+Or set up your development machine:
+
+```bash
+wundr computer-setup
+```
+
+### Verify Installation
+
+```bash
+wundr --version
+wundr --help
+```
+
+## Core Commands
+
+### Setup Commands
+
+Configure development environments and workstations.
+
+```bash
+# Computer provisioning
+wundr computer-setup [options]          # Interactive setup wizard
+wundr computer-setup --profile <role>   # Setup with specific profile
+wundr computer-setup --team <name>      # Apply team configuration
+wundr computer-setup validate           # Validate current setup
+wundr computer-setup doctor             # Diagnose issues
+
+# Profile management
+wundr computer-setup profile list       # List available profiles
+wundr computer-setup profile show       # Show profile details
+wundr computer-setup profile export     # Export current setup
+wundr computer-setup profile import     # Import custom profile
+
+# Claude Code integration
+wundr claude-setup                      # Setup Claude Code optimization
+wundr claude-init                       # Initialize Claude configuration
+```
+
+### Create Commands
+
+Generate projects, components, and services.
 
 ```bash
-wundr analyze deps --circular --unused
-wundr analyze quality --complexity --duplication
-wundr analyze all --report
+# Project creation
+wundr create project <type> [name]      # Create new project
+wundr create project nextjs my-app      # Create Next.js project
+wundr create project node-api server    # Create Node.js API
+
+# Component generation
+wundr create component <name>           # Create component
+wundr create component Button --react   # Create React component
+wundr create component --type vue       # Create Vue component
+
+# Service generation
+wundr create service <name>             # Create service
+wundr create service auth               # Create auth service
+wundr create service --template api     # Create from template
+
+# Template management
+wundr create template <name>            # Create custom template
+wundr create from-template <template>   # Create from template
 ```
 
-### Generate code
+### Analyze Commands
+
+Code analysis and dependency management.
 
 ```bash
-wundr create component UserCard --type react --with-tests
-wundr create service UserService --framework express --with-docs
+# Dependency analysis
+wundr analyze deps                      # Analyze all dependencies
+wundr analyze deps --circular           # Find circular dependencies
+wundr analyze deps --unused             # Find unused dependencies
+wundr analyze deps --outdated           # Check for outdated packages
+wundr analyze deps --security           # Run security audit
+
+# Code quality analysis
+wundr analyze quality                   # Analyze code quality
+wundr analyze quality --path ./src      # Analyze specific path
+wundr analyze quality --threshold 80    # Set quality threshold
+
+# Performance analysis
+wundr analyze performance               # Analyze performance
+wundr analyze bundle                    # Analyze bundle size
+wundr analyze metrics                   # Show code metrics
+
+# Drift detection
+wundr analyze drift                     # Detect code drift
+wundr analyze drift --baseline          # Create drift baseline
+wundr analyze drift --trends            # Show drift trends
 ```
 
-### AI-powered development
+### Govern Commands
+
+Governance, compliance, and quality enforcement.
 
 ```bash
-wundr ai chat
-wundr ai review src/components/
-wundr ai generate function --prompt "Sort array by date"
+# Policy management
+wundr govern policy list                # List policies
+wundr govern policy apply <policy>      # Apply policy
+wundr govern policy validate            # Validate against policies
+
+# Compliance reporting
+wundr govern report                     # Generate compliance report
+wundr govern report --weekly            # Generate weekly report
+wundr govern report --format json       # Export as JSON
+
+# Pattern standardization
+wundr govern standardize                # Auto-fix code patterns
+wundr govern standardize --pattern      # Fix specific pattern
+wundr govern standardize --review       # Review changes
+
+# Quality gates
+wundr govern gate check                 # Check quality gates
+wundr govern gate enforce               # Enforce quality gates
+wundr govern gate status                # Show gate status
 ```
 
-### Start dashboard
+### Init Commands
+
+Project initialization and configuration.
 
 ```bash
-wundr dashboard start --open
+# Project initialization
+wundr init project [name]               # Initialize new project
+wundr init project --template <type>    # Use specific template
+wundr init project --monorepo           # Initialize as monorepo
+
+# Configuration
+wundr init config                       # Initialize configuration
+wundr init config --interactive         # Interactive setup
+wundr init config --global              # Global configuration
+
+# Workspace setup
+wundr init workspace                    # Create workspace
+wundr init plugins                      # Setup plugin system
 ```
 
-## 📋 Command Categories
+### AI Commands
 
-### `wundr init`
+AI-powered development features.
 
-- `init project [name]` - Initialize new project
-- `init config` - Setup configuration
-- `init workspace` - Create multi-project workspace
-- `init plugins` - Setup plugin system
+```bash
+# Setup & configuration
+wundr ai setup                          # Interactive AI setup
+wundr ai status                         # Check AI status
+wundr ai validate                       # Validate AI connection
 
-### `wundr create`
+# Code generation
+wundr ai generate <type>                # Generate code
+wundr ai generate component             # Generate component
+wundr ai generate function --prompt     # Generate from prompt
+
+# Code assistance
+wundr ai review <file>                  # AI code review
+wundr ai refactor <target>              # Refactor code
+wundr ai optimize <target>              # Optimize performance
+
+# Documentation & tests
+wundr ai docs <target>                  # Generate docs
+wundr ai test <target>                  # Generate tests
+wundr ai analyze <target>               # AI analysis
+
+# Interactive chat
+wundr ai chat                           # Start AI chat
+```
 
-- `create component <name>` - Generate components
-- `create service <name>` - Generate services
-- `create package <name>` - Create monorepo packages
-- `create template <name>` - Create code templates
-- `create workflow <name>` - Generate CI/CD workflows
+### Dashboard Commands
 
-### `wundr analyze`
+Monitoring and visualization.
 
-- `analyze deps` - Dependency analysis
-- `analyze quality` - Code quality metrics
-- `analyze perf` - Performance analysis
-- `analyze arch` - Architecture review
-- `analyze all` - Comprehensive analysis
+```bash
+# Dashboard control
+wundr dashboard start                   # Launch web dashboard
+wundr dashboard start --port 3000       # Specify port
+wundr dashboard stop                    # Stop dashboard
 
-### `wundr govern`
+# Configuration
+wundr dashboard config                  # Configure dashboard
+wundr dashboard config set theme dark   # Set theme
 
-- `govern check` - Run compliance checks
-- `govern rules` - Manage governance rules
-- `govern policy` - Policy management
-- `govern gate` - Quality gates
-- `govern audit` - Governance auditing
+# Reports
+wundr dashboard report <type>           # Generate report
+```
 
-### `wundr ai`
+### Watch Commands
 
-- `ai setup` - Setup AI configuration and API keys
-- `ai status` - Check AI configuration status
-- `ai validate` - Validate AI connection
-- `ai generate <type>` - Code generation
-- `ai review [files...]` - Code review
-- `ai refactor <target>` - Code refactoring
-- `ai docs <target>` - Documentation generation
-- `ai chat` - Interactive AI chat
-- `ai analyze <target>` - AI-powered analysis
-- `ai test <target>` - Generate tests
-- `ai optimize <target>` - Performance optimization
+Real-time monitoring and automation.
 
-### `wundr dashboard`
+```bash
+# File watching
+wundr watch start [patterns]            # Watch files
+wundr watch test                        # Watch and run tests
+wundr watch build                       # Watch and build
+wundr watch lint                        # Watch and lint
+
+# Analysis watching
+wundr watch analyze --type quality      # Watch quality
+```
 
-- `dashboard start` - Launch web dashboard
-- `dashboard stop` - Stop dashboard
-- `dashboard config` - Configure dashboard
-- `dashboard report <type>` - Generate reports
+### Batch Commands
 
-### `wundr watch`
+Batch operations and automation.
 
-- `watch start [patterns...]` - Start file watching
-- `watch test` - Watch and run tests
-- `watch build` - Watch and build
-- `watch lint` - Watch and lint
+```bash
+# Batch processing
+wundr batch run <file>                  # Execute batch job
+wundr batch create <name>               # Create batch job
+wundr batch validate <file>             # Validate batch YAML
+wundr batch schedule <file>             # Schedule execution
+```
 
-### `wundr batch`
+### Chat Commands
 
-- `batch run <file>` - Execute batch job
-- `batch create <name>` - Create batch job
-- `batch validate <file>` - Validate batch YAML
-- `batch schedule <file>` - Schedule execution
+Natural language interface.
 
-### `wundr chat`
+```bash
+# Chat interaction
+wundr chat start                        # Start chat session
+wundr chat ask <message>                # Single question
+wundr chat file <file>                  # Chat about file
+wundr chat resume <sessionId>           # Resume session
+```
 
-- `chat start` - Start chat session
-- `chat ask <message>` - Single question
-- `chat file <file>` - Chat about file
-- `chat resume <sessionId>` - Resume session
+### Plugin Commands
 
-### `wundr plugin`
+Plugin management and development.
 
-- `plugin list` - List plugins
-- `plugin install <plugin>` - Install plugin
-- `plugin create <name>` - Create plugin
-- `plugin dev link <path>` - Link for development
+```bash
+# Plugin management
+wundr plugin list                       # List installed plugins
+wundr plugin install <plugin>           # Install plugin
+wundr plugin create <name>              # Create new plugin
+wundr plugin dev link <path>            # Link for development
+```
 
-## 🧙 Interactive Modes
+## Interactive Modes
 
 ### Wizard Mode
 
-Step-by-step guided setup and configuration:
+Guided interactive setup for common tasks.
+
+```bash
+# Launch wizard
+wundr wizard
+
+# Specific wizard mode
+wundr wizard --mode setup     # Setup wizard
+wundr wizard --mode analyze   # Analysis wizard
+wundr wizard --mode create    # Creation wizard
+```
+
+### Chat Interface
+
+Natural language command interface (AI-powered).
+
+```bash
+# Launch chat
+wundr chat
+
+# Chat with specific context
+wundr chat --context ./src
+
+# Chat with specific model
+wundr chat --model claude-3
+```
+
+### Terminal UI (TUI)
+
+Full-featured terminal dashboard.
+
+```bash
+# Launch TUI
+wundr tui
+
+# Specific layout
+wundr tui --layout dashboard    # Dashboard view
+wundr tui --layout monitor      # Monitoring view
+wundr tui --layout debug        # Debug view
+```
+
+## AI Integration
+
+Wundr CLI is **AI-native** with deep integration for intelligent automation:
+
+### Claude Code Optimization
+
+Optimize your development environment for Claude Code AI assistant.
 
 ```bash
-wundr wizard          # General wizard
-wundr wizard setup    # Project setup
-wundr wizard analyze  # Analysis configuration
-wundr wizard create   # Code generation
+# Setup Claude Code
+wundr claude-setup
+
+# Initialize Claude configuration
+wundr claude-init
+
+# Generate CLAUDE.md configuration
+wundr claude-init --generate
 ```
 
-### Chat Mode
+### AI Provider Setup
+
+Wundr supports multiple AI providers for enhanced development assistance:
+
+```bash
+# Interactive setup (recommended)
+wundr ai setup
+
+# Manual setup with Claude
+wundr ai setup --provider claude --api-key your-key
+
+# Validate configuration
+wundr ai validate
+
+# Check status
+wundr ai status
+```
 
-Natural language interface for development:
+### Environment Variables
 
 ```bash
-wundr chat start
-wundr chat ask "How do I optimize this React component?"
-wundr chat file src/component.tsx --action review
+# Claude (Anthropic)
+export CLAUDE_API_KEY=your_api_key_here
+
+# OpenAI (coming soon)
+export OPENAI_API_KEY=your_api_key_here
+
+# Provider selection
+export WUNDR_AI_PROVIDER=claude
+export WUNDR_AI_MODEL=claude-3-opus-20240229
 ```
 
-### TUI Mode
+### AI-Powered Features
+
+- **Smart Code Analysis**: AI-driven code quality insights
+- **Intelligent Refactoring**: Context-aware code improvements
+- **Auto-Documentation**: Generate documentation from code
+- **Test Generation**: AI-generated test suites
+- **Code Review**: Automated AI code reviews
+- **Performance Optimization**: AI-powered performance suggestions
+
+## Example Workflows
+
+### Onboarding a New Developer
+
+```bash
+# 1. Setup development machine
+wundr computer-setup --profile fullstack
+
+# 2. Validate installation
+wundr computer-setup validate
+
+# 3. Clone and initialize project
+git clone <repo>
+cd <project>
+wundr init config
+
+# 4. Verify everything works
+wundr govern gate check
+```
 
-Terminal user interface with real-time updates:
+### Starting a New Project
 
 ```bash
-wundr tui              # Dashboard layout
-wundr tui --layout monitor  # Monitoring layout
-wundr tui --layout debug    # Debug information
+# 1. Create project
+wundr create project nextjs my-startup-app
+
+# 2. Navigate to project
+cd my-startup-app
+
+# 3. Initialize governance
+wundr init config --interactive
+
+# 4. Create initial components
+wundr create component Hero
+wundr create component Layout
+
+# 5. Run quality check
+wundr analyze quality
 ```
 
-### Watch Mode
+### Maintaining Code Quality
+
+```bash
+# 1. Check for drift
+wundr analyze drift
+
+# 2. Analyze dependencies
+wundr analyze deps --circular --unused --security
+
+# 3. Run quality analysis
+wundr analyze quality --threshold 80
+
+# 4. Auto-standardize patterns
+wundr govern standardize
 
-Real-time file monitoring and automation:
+# 5. Generate compliance report
+wundr govern report --weekly
+```
+
+### Team Configuration
 
 ```bash
-wundr watch start "src/**/*.ts" --command "npm run build"
-wundr watch test       # Auto-run tests on changes
-wundr watch lint --fix # Auto-fix linting issues
+# 1. Export your setup
+wundr computer-setup profile export > team-setup.json
+
+# 2. Share with team
+
+# 3. Team members import
+wundr computer-setup profile import team-setup.json
+
+# 4. Apply team configuration
+wundr computer-setup --team engineering
 ```
 
-## 🔧 Configuration
+## Configuration
 
 ### Global Configuration
 
-Stored in `~/.wundr/config.json`:
+Create a global configuration file at `~/.wundr/config.json`:
 
 ```json
 {
-  "defaultMode": "cli",
+  "defaultProfile": "fullstack",
+  "teamConfig": "platform-engineering",
   "ai": {
     "provider": "claude",
-    "model": "claude-3"
+    "model": "claude-3-opus-20240229",
+    "enabled": true
+  },
+  "governance": {
+    "enforceGates": true,
+    "autoStandardize": true
+  },
+  "dashboard": {
+    "port": 3000,
+    "theme": "dark"
   },
   "plugins": ["@wundr/plugin-git"],
   "integrations": {
     "github": {
       "token": "your-token",
-      "owner": "your-org",
-      "repo": "your-repo"
+      "owner": "your-org"
     }
   }
 }
@@ -223,34 +583,87 @@ Stored in `~/.wundr/config.json`:
 
 ### Project Configuration
 
-Project-specific settings in `wundr.config.json`:
+Create a project configuration file at `.wundr/config.json` or `wundr.config.json`:
 
 ```json
 {
+  "version": "1.0",
+  "project": {
+    "name": "my-project",
+    "type": "nextjs",
+    "framework": "react"
+  },
   "analysis": {
     "patterns": ["**/*.ts", "**/*.tsx"],
     "excludes": ["**/node_modules/**"],
-    "maxDepth": 10
+    "thresholds": {
+      "quality": 80,
+      "coverage": 75,
+      "complexity": 10
+    }
   },
   "governance": {
+    "policies": ["security", "quality", "performance"],
     "rules": ["no-console", "require-tests"],
-    "severity": "warning"
+    "severity": "warning",
+    "gates": {
+      "preCommit": ["quality", "lint", "test"],
+      "preMerge": ["coverage", "security", "review"]
+    }
   }
 }
 ```
 
-## 🔌 Plugin System
+### Environment Variables
+
+```bash
+# Configuration
+WUNDR_CONFIG_PATH=~/.wundr/config.json
+WUNDR_PROFILE=fullstack
+WUNDR_TEAM=platform-engineering
+
+# AI Configuration
+WUNDR_AI_ENABLED=true
+WUNDR_AI_PROVIDER=claude
+WUNDR_AI_MODEL=claude-3-opus-20240229
+CLAUDE_API_KEY=your_api_key_here
+
+# Dashboard
+WUNDR_DASHBOARD_PORT=3000
+WUNDR_DASHBOARD_HOST=localhost
+
+# Logging
+WUNDR_LOG_LEVEL=info
+WUNDR_LOG_FILE=~/.wundr/logs/wundr.log
+```
+
+## Plugin System
+
+Extend Wundr CLI with custom plugins.
 
 ### Installing Plugins
 
 ```bash
+# Install plugin
 wundr plugin install @wundr/plugin-docker
+
+# Install from npm
 wundr plugin install my-custom-plugin
+
+# Install from git
 wundr plugin install git+https://github.com/user/plugin.git
+
+# List plugins
+wundr plugin list
+
+# Remove plugin
+wundr plugin uninstall @wundr/plugin-docker
 ```
 
 ### Creating Plugins
 
+Create a new plugin:
+
 ```bash
 wundr plugin create my-awesome-plugin --interactive
 cd my-awesome-plugin
@@ -258,10 +671,10 @@ npm install
 wundr plugin dev link .
 ```
 
-### Plugin Structure
+Plugin structure:
 
 ```typescript
-import { Plugin, PluginContext } from '@wundr/cli';
+import { Plugin, PluginContext } from '@wundr.io/cli';
 
 export default class MyPlugin implements Plugin {
   name = 'my-plugin';
@@ -284,7 +697,7 @@ export default class MyPlugin implements Plugin {
 }
 ```
 
-## 📊 Batch Processing
+## Batch Processing
 
 ### YAML Batch Jobs
 
@@ -320,232 +733,235 @@ wundr batch run build-pipeline.yaml --dry-run
 wundr batch run build-pipeline.yaml --vars '{"NODE_ENV": "production"}'
 ```
 
-## 🤖 AI Integration
+## Related Packages
 
-### Setup & Configuration
+Wundr CLI integrates with the entire Wundr ecosystem:
 
-Wundr CLI integrates with AI providers for intelligent development assistance. Currently supports Claude (Anthropic) with OpenAI support coming soon.
+- **[@wundr.io/computer-setup](../computer-setup)** - Developer machine provisioning (integrated)
+- **[@wundr.io/core](../core)** - Core utilities and shared functionality
+- **[@wundr.io/config](../config)** - Configuration management system
+- **[@wundr.io/analysis-engine](../analysis-engine)** - Code analysis and metrics
+- **[@wundr.io/project-templates](../project-templates)** - Project scaffolding templates
+- **[@wundr.io/dashboard](../dashboard)** - Web dashboard and visualization
+- **[@wundr.io/security](../security)** - Security scanning and compliance
+- **[@wundr.io/environment](../environment)** - Environment management utilities
 
-#### Quick Setup
+## Documentation
 
-```bash
-# Interactive setup (recommended)
-wundr ai setup
+- **[Full Documentation](../docs)** - Comprehensive guides and API reference
+- **[Computer Setup Guide](../computer-setup/README.md)** - Developer provisioning details
+- **[Configuration Guide](../docs/configuration.md)** - Configuration options
+- **[Plugin Development](../docs/plugins.md)** - Creating custom plugins
+- **[API Reference](../docs/api.md)** - CLI API documentation
+- **[Examples](../docs/examples)** - Real-world usage examples
 
-# Manual setup
-wundr ai setup --provider claude --api-key your-key-here
+## Global Options
 
-# Validate configuration
-wundr ai validate
+Available for all commands:
+
+```bash
+--config <path>          # Specify config file path
+--verbose                # Enable verbose logging
+--quiet                  # Suppress output
+--no-color               # Disable colored output
+--dry-run                # Show what would be done without executing
+--interactive            # Force interactive mode
+-v, --version            # Display version number
+-h, --help               # Display help for command
 ```
 
-#### Environment Variables
+## Advanced Usage
+
+### Monorepo Support
 
-Set your API key via environment variables:
+Full support for monorepo architectures:
 
 ```bash
-# Claude (Anthropic)
-export CLAUDE_API_KEY=your_api_key_here
+# Initialize monorepo
+wundr init project --monorepo
 
-# OpenAI (coming soon)
-export OPENAI_API_KEY=your_api_key_here
+# Analyze monorepo
+wundr analyze deps --monorepo
 
-# Optional: Provider and model selection
-export WUNDR_AI_PROVIDER=claude
-export WUNDR_AI_MODEL=claude-3-opus-20240229
+# Create package
+wundr create package <name>
 ```
 
-#### Configuration File
+### CI/CD Integration
 
-Manually configure in `~/.wundr/config.json`:
+Use Wundr CLI in your CI/CD pipelines:
 
-```json
-{
-  "ai": {
-    "provider": "claude",
-    "model": "claude-3-opus-20240229",
-    "apiKey": "your-api-key-here"
-  }
-}
+```yaml
+# .github/workflows/quality.yml
+- name: Quality Check
+  run: |
+    npx @wundr.io/cli analyze quality --threshold 80
+    npx @wundr.io/cli govern gate check
+    npx @wundr.io/cli analyze deps --security
 ```
 
-#### Getting API Keys
+### Custom Profiles
 
-**Claude (Anthropic)**:
-1. Visit [Anthropic Console](https://console.anthropic.com)
-2. Create an account or sign in
-3. Generate an API key in your dashboard
-4. Copy the key and use in setup
-
-### AI Commands
+Create custom developer profiles:
 
 ```bash
-# Setup and status
-wundr ai setup          # Interactive setup wizard
-wundr ai status         # Check configuration status
-wundr ai validate       # Test API connection
+# Create custom profile
+wundr computer-setup profile create
 
-# Code generation
-wundr ai generate component --prompt "Create a user profile card"
-wundr ai generate function --prompt "Sort array by date"
+# Edit profile
+wundr computer-setup profile edit my-profile
+
+# Share profile
+wundr computer-setup profile export my-profile > my-profile.json
+```
 
-# Code review and analysis
-wundr ai review src/ --focus security --suggest-fixes
-wundr ai analyze src/component.tsx --suggestions
+## Troubleshooting
 
-# Interactive assistance
-wundr ai chat --context src/
-wundr ai chat          # Start interactive session
+### Common Issues
+
+**Command not found:**
 
-# Documentation and tests
-wundr ai docs src/utils.ts --type api --include-examples
-wundr ai test src/service.ts --framework jest --coverage unit
+```bash
+# Ensure installation
+npm list -g @wundr.io/cli
 
-# Code optimization
-wundr ai optimize src/component.tsx --focus performance
-wundr ai refactor src/legacy.js --type modernize
+# Reinstall if needed
+npm install -g @wundr.io/cli
 ```
 
-### Error Handling
+**Permission errors:**
+
+```bash
+# Use npx instead
+npx @wundr.io/cli <command>
+
+# Or configure npm global
+npm config set prefix ~/.npm-global
+export PATH=~/.npm-global/bin:$PATH
+```
 
-If AI features aren't working:
+**AI features not working:**
 
 ```bash
-# Check status
+# Check AI status
 wundr ai status
 
 # Validate connection
 wundr ai validate
 
-# Re-run setup if needed
+# Re-run setup
 wundr ai setup --validate
 ```
 
-Common issues:
-- **API key not configured**: Run `wundr ai setup`
-- **Invalid API key**: Check your key at the provider console
-- **Network issues**: Verify internet connection
-- **Rate limits**: Wait and try again, or check your usage
-
-## 📊 Dashboard & Monitoring
-
-### Web Dashboard
+**Configuration issues:**
 
 ```bash
-wundr dashboard start --port 3000 --open
-wundr dashboard config set theme dark
-wundr dashboard widget add metrics --position '{"x": 0, "y": 0}'
-```
+# Reset configuration
+wundr init config --reset
 
-### Real-time Monitoring
-
-```bash
-wundr watch analyze --type quality --threshold 80
-wundr watch start "src/**" --command "wundr analyze quality"
+# Validate configuration
+wundr init config --validate
 ```
 
-## 🌍 Cross-Platform Compatibility
-
-The Wundr CLI works seamlessly across platforms:
-
-- **macOS**: Full feature support
-- **Linux**: Full feature support
-- **Windows**: Full feature support with PowerShell/CMD
-- **Docker**: Container-ready
+### Debug Mode
 
-### Windows-specific Notes
+```bash
+# Verbose logging
+wundr --verbose <command>
 
-```powershell
-# PowerShell
-wundr init project my-app
-wundr wizard
+# Debug TUI
+wundr tui --layout debug
 
-# Command Prompt
-wundr.cmd analyze deps
-wundr.cmd dashboard start
+# Environment debug
+DEBUG=wundr:* wundr <command>
 ```
 
-## 🔍 Troubleshooting
-
-### Common Issues
-
-1. **Command not found**
+### Getting Help
 
-   ```bash
-   npm install -g @wundr/cli
-   # or
-   npx @wundr/cli --version
-   ```
+```bash
+# General help
+wundr --help
 
-2. **Permission errors**
+# Command-specific help
+wundr computer-setup --help
+wundr create --help
+wundr analyze --help
 
-   ```bash
-   sudo npm install -g @wundr/cli  # macOS/Linux
-   # or use npm prefix
-   npm config set prefix ~/.npm-global
-   ```
+# Diagnostic mode
+wundr computer-setup doctor
+```
 
-3. **Plugin installation fails**
+## Performance
 
-   ```bash
-   wundr plugin list
-   wundr plugin install <plugin> --force
-   ```
+Wundr CLI is optimized for speed and efficiency:
 
-4. **TypeScript compilation errors**
-   ```bash
-   npm run build
-   wundr --version  # Verify installation
-   ```
+- **Parallel Execution**: Multiple operations run concurrently
+- **Smart Caching**: Intelligent caching reduces redundant work
+- **Incremental Analysis**: Only analyze changed files
+- **Lazy Loading**: Plugins loaded on-demand
+- **Minimal Dependencies**: Lean core with optional extensions
 
-### Debug Mode
+## Requirements
 
-```bash
-wundr --verbose <command>
-wundr tui --layout debug
-DEBUG=wundr:* wundr <command>
-```
+- **Node.js**: >= 18.0.0
+- **npm**: >= 8.0.0 (or pnpm/yarn)
+- **Git**: >= 2.0.0 (for project creation)
+- **Disk Space**: 500MB minimum (for full setup)
+- **Network**: Required for package installation and AI features
 
-## 🤝 Contributing
+## Contributing
 
-1. Fork the repository
-2. Create a feature branch: `git checkout -b feature/amazing-feature`
-3. Commit changes: `git commit -m 'Add amazing feature'`
-4. Push to branch: `git push origin feature/amazing-feature`
-5. Open a Pull Request
+We welcome contributions! Please see our [Contributing Guide](../../CONTRIBUTING.md).
 
 ### Development Setup
 
 ```bash
+# Clone repository
 git clone https://github.com/adapticai/wundr.git
 cd wundr/packages/@wundr/cli
+
+# Install dependencies
 npm install
+
+# Build
 npm run build
+
+# Run tests
+npm test
+
+# Link for local development
 npm link
 ```
 
-## 📝 License
+### Testing
+
+```bash
+# Run tests
+npm test
 
-MIT License - see [LICENSE](LICENSE) file for details.
+# Watch mode
+npm run test:watch
+
+# Type checking
+npm run typecheck
+
+# Linting
+npm run lint
+```
 
-## 🙋 Support
+## License
 
-- 📚 [Documentation](https://wundr.io/docs)
-- 💬 [Discord Community](https://discord.gg/wundr)
-- 🐛 [Issue Tracker](https://github.com/adapticai/wundr/issues)
-- 📧 [Email Support](mailto:support@wundr.io)
+MIT - See [LICENSE](../../../LICENSE) for details.
 
-## 🚀 What's Next?
+## Support
 
-- Enhanced AI model support
-- Visual Studio Code extension
-- GitHub Actions integration
-- Team collaboration features
-- Performance analytics
-- Custom rule engine
+- **Issues**: [GitHub Issues](https://github.com/adapticai/wundr/issues)
+- **Documentation**: [https://wundr.io/docs](https://wundr.io)
+- **Community**: [Discord](https://discord.gg/wundr)
+- **Email**: support@wundr.io
 
 ---
 
-**Made with ❤️ by the Wundr team**
+**Built by [Adaptic.ai](https://adaptic.ai)** - Transforming how teams build software.
 
-_Transform your development workflow with intelligent automation and architectural excellence._
+_From chaos to excellence, systematically._