Unified CLI framework for the Wundr platform
npm install @wundr.io/cli
From chaos to excellence, systematically.
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.
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.
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:
``bashInteractive setup wizard
wundr computer-setup
$3
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
Interactive project creation
wundr create projectCreate with specific template
wundr create project nextjs my-app --typescriptCreate component
wundr create component Button --type reactCreate service
wundr create service auth --template microservice
`$3
Automated code analysis, dependency management, and quality enforcement.
Key Capabilities:
- Dependency analysis (circular, unused, outdated, security)
- Code quality metrics and drift detection
- Automated pattern standardization
- Compliance reporting
- Real-time monitoring
Example:
bash
Analyze dependencies
wundr analyze deps --circular --securityCheck code quality
wundr analyze quality --path ./srcDetect code drift
wundr analyze driftGenerate compliance report
wundr govern report --weekly
`Quick Start
$3
Install globally via npm:
bash
npm install -g @wundr.io/cli
`Or use with npx (no installation required):
bash
npx @wundr.io/cli --help
`$3
Run the interactive wizard to get started:
bash
wundr wizard
`Or set up your development machine:
bash
wundr computer-setup
`$3
bash
wundr --version
wundr --help
`Core Commands
$3
Configure development environments and workstations.
bash
Computer provisioning
wundr computer-setup [options] # Interactive setup wizard
wundr computer-setup --profile # Setup with specific profile
wundr computer-setup --team # Apply team configuration
wundr computer-setup validate # Validate current setup
wundr computer-setup doctor # Diagnose issuesProfile 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 profileClaude Code integration
wundr claude-setup # Setup Claude Code optimization
wundr claude-init # Initialize Claude configuration
`$3
Generate projects, components, and services.
bash
Project creation
wundr create project [name] # Create new project
wundr create project nextjs my-app # Create Next.js project
wundr create project node-api server # Create Node.js APIComponent generation
wundr create component # Create component
wundr create component Button --react # Create React component
wundr create component --type vue # Create Vue componentService generation
wundr create service # Create service
wundr create service auth # Create auth service
wundr create service --template api # Create from templateTemplate management
wundr create template # Create custom template
wundr create from-template # Create from template
`$3
Code analysis and dependency management.
bash
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 auditCode quality analysis
wundr analyze quality # Analyze code quality
wundr analyze quality --path ./src # Analyze specific path
wundr analyze quality --threshold 80 # Set quality thresholdPerformance analysis
wundr analyze performance # Analyze performance
wundr analyze bundle # Analyze bundle size
wundr analyze metrics # Show code metricsDrift detection
wundr analyze drift # Detect code drift
wundr analyze drift --baseline # Create drift baseline
wundr analyze drift --trends # Show drift trends
`$3
Governance, compliance, and quality enforcement.
bash
Policy management
wundr govern policy list # List policies
wundr govern policy apply # Apply policy
wundr govern policy validate # Validate against policiesCompliance reporting
wundr govern report # Generate compliance report
wundr govern report --weekly # Generate weekly report
wundr govern report --format json # Export as JSONPattern standardization
wundr govern standardize # Auto-fix code patterns
wundr govern standardize --pattern # Fix specific pattern
wundr govern standardize --review # Review changesQuality gates
wundr govern gate check # Check quality gates
wundr govern gate enforce # Enforce quality gates
wundr govern gate status # Show gate status
`$3
Project initialization and configuration.
bash
Project initialization
wundr init project [name] # Initialize new project
wundr init project --template # Use specific template
wundr init project --monorepo # Initialize as monorepoConfiguration
wundr init config # Initialize configuration
wundr init config --interactive # Interactive setup
wundr init config --global # Global configurationWorkspace setup
wundr init workspace # Create workspace
wundr init plugins # Setup plugin system
`$3
AI-powered development features.
bash
Setup & configuration
wundr ai setup # Interactive AI setup
wundr ai status # Check AI status
wundr ai validate # Validate AI connectionCode generation
wundr ai generate # Generate code
wundr ai generate component # Generate component
wundr ai generate function --prompt # Generate from promptCode assistance
wundr ai review # AI code review
wundr ai refactor # Refactor code
wundr ai optimize # Optimize performanceDocumentation & tests
wundr ai docs # Generate docs
wundr ai test # Generate tests
wundr ai analyze # AI analysisInteractive chat
wundr ai chat # Start AI chat
`$3
Monitoring and visualization.
bash
Dashboard control
wundr dashboard start # Launch web dashboard
wundr dashboard start --port 3000 # Specify port
wundr dashboard stop # Stop dashboardConfiguration
wundr dashboard config # Configure dashboard
wundr dashboard config set theme dark # Set themeReports
wundr dashboard report # Generate report
`$3
Real-time monitoring and automation.
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 lintAnalysis watching
wundr watch analyze --type quality # Watch quality
`$3
Batch operations and automation.
bash
Batch processing
wundr batch run # Execute batch job
wundr batch create # Create batch job
wundr batch validate # Validate batch YAML
wundr batch schedule # Schedule execution
`$3
Natural language interface.
bash
Chat interaction
wundr chat start # Start chat session
wundr chat ask # Single question
wundr chat file # Chat about file
wundr chat resume # Resume session
`$3
Plugin management and development.
bash
Plugin management
wundr plugin list # List installed plugins
wundr plugin install # Install plugin
wundr plugin create # Create new plugin
wundr plugin dev link # Link for development
`Interactive Modes
$3
Guided interactive setup for common tasks.
bash
Launch wizard
wundr wizardSpecific wizard mode
wundr wizard --mode setup # Setup wizard
wundr wizard --mode analyze # Analysis wizard
wundr wizard --mode create # Creation wizard
`$3
Natural language command interface (AI-powered).
bash
Launch chat
wundr chatChat with specific context
wundr chat --context ./srcChat with specific model
wundr chat --model claude-3
`$3
Full-featured terminal dashboard.
bash
Launch TUI
wundr tuiSpecific 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:
$3
Optimize your development environment for Claude Code AI assistant.
bash
Setup Claude Code
wundr claude-setupInitialize Claude configuration
wundr claude-initGenerate CLAUDE.md configuration
wundr claude-init --generate
`$3
Wundr supports multiple AI providers for enhanced development assistance:
bash
Interactive setup (recommended)
wundr ai setupManual setup with Claude
wundr ai setup --provider claude --api-key your-keyValidate configuration
wundr ai validateCheck status
wundr ai status
`$3
bash
Claude (Anthropic)
export CLAUDE_API_KEY=your_api_key_hereOpenAI (coming soon)
export OPENAI_API_KEY=your_api_key_hereProvider selection
export WUNDR_AI_PROVIDER=claude
export WUNDR_AI_MODEL=claude-3-opus-20240229
`$3
- 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
$3
bash
1. Setup development machine
wundr computer-setup --profile fullstack2. Validate installation
wundr computer-setup validate3. Clone and initialize project
git clone
cd
wundr init config4. Verify everything works
wundr govern gate check
`$3
bash
1. Create project
wundr create project nextjs my-startup-app2. Navigate to project
cd my-startup-app3. Initialize governance
wundr init config --interactive4. Create initial components
wundr create component Hero
wundr create component Layout5. Run quality check
wundr analyze quality
`$3
bash
1. Check for drift
wundr analyze drift2. Analyze dependencies
wundr analyze deps --circular --unused --security3. Run quality analysis
wundr analyze quality --threshold 804. Auto-standardize patterns
wundr govern standardize5. Generate compliance report
wundr govern report --weekly
`$3
bash
1. Export your setup
wundr computer-setup profile export > team-setup.json2. Share with team
3. Team members import
wundr computer-setup profile import team-setup.json4. Apply team configuration
wundr computer-setup --team engineering
`Configuration
$3
Create a global configuration file at
:`json
{
"defaultProfile": "fullstack",
"teamConfig": "platform-engineering",
"ai": {
"provider": "claude",
"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"
}
}
}
`$3
Create a project configuration file at
or wundr.config.json:`json
{
"version": "1.0",
"project": {
"name": "my-project",
"type": "nextjs",
"framework": "react"
},
"analysis": {
"patterns": ["/.ts", "/.tsx"],
"excludes": ["/node_modules/"],
"thresholds": {
"quality": 80,
"coverage": 75,
"complexity": 10
}
},
"governance": {
"policies": ["security", "quality", "performance"],
"rules": ["no-console", "require-tests"],
"severity": "warning",
"gates": {
"preCommit": ["quality", "lint", "test"],
"preMerge": ["coverage", "security", "review"]
}
}
}
`$3
bash
Configuration
WUNDR_CONFIG_PATH=~/.wundr/config.json
WUNDR_PROFILE=fullstack
WUNDR_TEAM=platform-engineeringAI Configuration
WUNDR_AI_ENABLED=true
WUNDR_AI_PROVIDER=claude
WUNDR_AI_MODEL=claude-3-opus-20240229
CLAUDE_API_KEY=your_api_key_hereDashboard
WUNDR_DASHBOARD_PORT=3000
WUNDR_DASHBOARD_HOST=localhostLogging
WUNDR_LOG_LEVEL=info
WUNDR_LOG_FILE=~/.wundr/logs/wundr.log
`Plugin System
Extend Wundr CLI with custom plugins.
$3
bash
Install plugin
wundr plugin install @wundr/plugin-dockerInstall from npm
wundr plugin install my-custom-pluginInstall from git
wundr plugin install git+https://github.com/user/plugin.gitList plugins
wundr plugin listRemove plugin
wundr plugin uninstall @wundr/plugin-docker
`$3
Create a new plugin:
bash
wundr plugin create my-awesome-plugin --interactive
cd my-awesome-plugin
npm install
wundr plugin dev link .
`Plugin structure:
typescript
import { Plugin, PluginContext } from '@wundr.io/cli';export default class MyPlugin implements Plugin {
name = 'my-plugin';
version = '1.0.0';
description = 'My awesome plugin';
async activate(context: PluginContext): Promise {
context.registerCommand({
name: 'my-command',
description: 'My custom command',
action: async (args, options, ctx) => {
ctx.logger.info('Plugin command executed!');
},
});
}
async deactivate(): Promise {
// Cleanup
}
}
`Batch Processing
$3
Create
:`yaml
name: build-and-test
description: Complete build and test pipeline
parallel: false
continueOnError: falsecommands:
- command: 'npm install'
retry: 2
- command: 'npm run lint'
condition: 'typescript-files'
- command: 'npm run test'
timeout: 300000
- command: 'npm run build'
- command: 'npm run deploy'
condition: 'production'
`Execute batch job:
bash
wundr batch run build-pipeline.yaml
wundr batch run build-pipeline.yaml --dry-run
wundr batch run build-pipeline.yaml --vars '{"NODE_ENV": "production"}'
`Related Packages
Wundr CLI integrates with the entire Wundr ecosystem:
- @wundr.io/computer-setup - Developer machine provisioning (integrated)
- @wundr.io/core - Core utilities and shared functionality
- @wundr.io/config - Configuration management system
- @wundr.io/analysis-engine - Code analysis and metrics
- @wundr.io/project-templates - Project scaffolding templates
- @wundr.io/dashboard - Web dashboard and visualization
- @wundr.io/security - Security scanning and compliance
- @wundr.io/environment - Environment management utilities
Documentation
- Full Documentation - Comprehensive guides and API reference
- Computer Setup Guide - Developer provisioning details
- Configuration Guide - Configuration options
- Plugin Development - Creating custom plugins
- API Reference - CLI API documentation
- Examples - Real-world usage examples
Global Options
Available for all commands:
bash
--config # 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
`Advanced Usage
$3
Full support for monorepo architectures:
bash
Initialize monorepo
wundr init project --monorepoAnalyze monorepo
wundr analyze deps --monorepoCreate package
wundr create package
`$3
Use Wundr CLI in your CI/CD pipelines:
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
`$3
Create custom developer profiles:
bash
Create custom profile
wundr computer-setup profile createEdit profile
wundr computer-setup profile edit my-profileShare profile
wundr computer-setup profile export my-profile > my-profile.json
`Troubleshooting
$3
Command not found:
bash
Ensure installation
npm list -g @wundr.io/cliReinstall if needed
npm install -g @wundr.io/cli
`Permission errors:
bash
Use npx instead
npx @wundr.io/cli Or configure npm global
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
`AI features not working:
bash
Check AI status
wundr ai statusValidate connection
wundr ai validateRe-run setup
wundr ai setup --validate
`Configuration issues:
bash
Reset configuration
wundr init config --resetValidate configuration
wundr init config --validate
`$3
bash
Verbose logging
wundr --verbose Debug TUI
wundr tui --layout debugEnvironment debug
DEBUG=wundr:* wundr
`$3
bash
General help
wundr --helpCommand-specific help
wundr computer-setup --help
wundr create --help
wundr analyze --helpDiagnostic mode
wundr computer-setup doctor
`Performance
Wundr CLI is optimized for speed and efficiency:
- 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
Requirements
- 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
We welcome contributions! Please see our Contributing Guide.
$3
bash
Clone repository
git clone https://github.com/adapticai/wundr.git
cd wundr/packages/@wundr/cliInstall dependencies
npm installBuild
npm run buildRun tests
npm testLink for local development
npm link
`$3
bash
Run tests
npm testWatch mode
npm run test:watchType checking
npm run typecheckLinting
npm run lint
``MIT - See LICENSE for details.
- Issues: GitHub Issues
- Documentation: https://wundr.io/docs
- Community: Discord
- Email: support@wundr.io
---
Built by Adaptic.ai - Transforming how teams build software.
_From chaos to excellence, systematically._