Cross-platform development environment setup and management tools
npm install @wundr.io/environmentCross-platform development environment setup and management tools for modern software development workflows.
- Multi-Platform Support: macOS, Linux, Windows, and Docker
- Profile-Based Setup: Human developer, AI agent, and CI/CD runner profiles
- Tool Management: Automated installation and configuration of development tools
- AI Agent Integration: Claude Code, Claude Flow, and MCP tools support
- Package Manager Support: npm, pnpm, and yarn integration
- Environment Validation: Comprehensive health checks and validation
- Docker Support: Containerized development environments
- CLI Interface: Powerful command-line interface for environment management
``bashInstall globally
npm install -g @wundr/environment
$3
`bash
Clone the repository
git clone https://github.com/wundr/wundr.git
cd wundr/packages/@wundr/environmentInstall dependencies
pnpm installBuild the package
pnpm run buildLink globally for development
pnpm link --global
`๐ฏ Quick Start
$3
`bash
Human developer environment (default)
wundr-env init --profile human --email your@email.com --name "Your Name"AI agent environment
wundr-env init --profile ai-agent --email agent@company.com --name "AI Agent"CI/CD runner environment
wundr-env init --profile ci-runner --yes
`$3
`bash
Install all configured tools
wundr-env installForce reinstall existing tools
wundr-env install --force
`$3
`bash
Quick validation
wundr-env validateDetailed validation with verbose output
wundr-env validate --verbose
`$3
`bash
Show current environment status
wundr-env statusList available profiles
wundr-env profiles
`๐ Environment Profiles
$3
Complete development environment for human developers:
- Tools: Node.js, Git, Docker, VS Code, Claude Code, GitHub CLI
- Features: Full IDE setup, extensions, AI assistance
- Use Case: Daily development work, coding, debugging
$3
Optimized environment for AI agents and automation:
- Tools: Node.js, Git, Claude Code, Claude Flow, MCP tools
- Features: Swarm intelligence, neural patterns, automation
- Use Case: Autonomous code generation, AI-driven development
$3
Minimal environment for continuous integration:
- Tools: Node.js, Git, essential build tools
- Features: Fast builds, testing framework, minimal footprint
- Use Case: Automated builds, testing, deployment pipelines
๐ ๏ธ Platform Support
$3
`bash
Automatic installation with Homebrew
./scripts/install/macos.sh
`Features:
- Homebrew package management
- Xcode Command Line Tools integration
- Native app installations (VS Code, Docker Desktop)
$3
`bash
Supports Ubuntu, Debian, Fedora, CentOS, Arch
./scripts/install/linux.sh
`Features:
- Multiple distribution support
- Package manager detection (apt, dnf, yum, pacman)
- Homebrew for Linux support
$3
`powershell
PowerShell script with Chocolatey and Winget
.\scripts\install\windows.ps1
`Features:
- Chocolatey and Windows Package Manager
- WSL2 integration
- PowerShell profile configuration
$3
`bash
Build and run containerized environments
docker-compose up human-dev # Human developer environment
docker-compose up ai-agent # AI agent environment
docker-compose up ci-runner # CI/CD runner environment
`๐ง AI Agent Integration
$3
`bash
Configure Claude Code with optimal settings
wundr-env update --profile ai-agent
`Features:
- Automatic model selection (Claude Opus 4.1)
- Code generation optimization
- Integration with development workflow
$3
`bash
Initialize swarm capabilities
claude-flow swarm init --agents 54
`Features:
- 54-agent swarm topology
- Neural pattern recognition
- Distributed memory system
- Consensus protocols
$3
`bash
Available MCP tools
- claude-flow: Orchestration and swarm management
- wundr-toolkit: Quality and governance tools
- filesystem: File operations
- git: Version control operations
- docker: Container management
`๐ง Configuration
$3
The environment configuration is stored in
~/.wundr/environment.json:`json
{
"profile": "human",
"platform": "macos",
"tools": [...],
"preferences": {
"editor": "vscode",
"shell": "zsh",
"packageManager": "pnpm",
"theme": "dark"
},
"paths": {
"development": "/Users/username/Development",
"config": "/Users/username/.wundr",
"cache": "/Users/username/.wundr/cache"
}
}
`$3
Profiles are defined in
templates/profiles/:-
human-developer.json: Full development environment
- ai-agent.json: AI agent optimized setup
- ci-runner.json: Minimal CI/CD setup$3
Tools are configured with dependencies, installers, and platform support:
`json
{
"name": "vscode",
"required": true,
"installer": "brew",
"platform": ["macos", "linux"],
"config": {
"extensions": ["ms-vscode.vscode-typescript-next"],
"settings": {"editor.formatOnSave": true}
}
}
`๐ข Docker Environments
$3
`bash
Start with VS Code Server
docker-compose up human-dev
Access VS Code at http://localhost:8080
`$3
`bash
Start with Claude Flow orchestration
docker-compose up ai-agent
Claude Flow API at http://localhost:3100
`$3
`bash
Override for development
docker-compose -f docker-compose.yml -f docker-compose.dev.yml upProduction deployment
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d
`๐ Validation & Health Checks
$3
`bash
Comprehensive validation
wundr-env validate --verbose
`Checks:
- Tool installation and versions
- Platform compatibility
- Dependency resolution
- Configuration integrity
$3
`bash
Essential tools check
node --version && npm --version && git --version
`$3
- Health check endpoints in Docker containers
- Prometheus metrics collection
- Grafana dashboard visualization
๐งช Testing
$3
`bash
Run unit tests
pnpm testRun with coverage
pnpm test:coverage
`$3
`bash
Test full environment setup
pnpm test:integrationTest specific platform
PLATFORM=macos pnpm test:integration
`$3
`bash
Test complete workflow
pnpm test:e2e
`๐ API Reference
$3
Main class for environment management:
`typescript
import { EnvironmentManager } from '@wundr/environment';const manager = new EnvironmentManager();
// Initialize environment
await manager.initialize('human', {
email: 'user@example.com',
fullName: 'User Name'
});
// Install tools
await manager.installEnvironment();
// Validate setup
const health = await manager.validateEnvironment();
`$3
Manage environment profiles:
`typescript
import { ProfileManager } from '@wundr/environment';const profiles = new ProfileManager();
// Get profile template
const template = await profiles.getProfileTemplate('ai-agent');
// Register custom profile
profiles.registerProfile(customProfile);
`$3
Handle tool installation and validation:
`typescript
import { ToolManager } from '@wundr/environment';const tools = new ToolManager();
// Install tool
await tools.installTool(toolConfig);
// Validate tool
const result = await tools.validateTool(toolConfig);
`๐ค Contributing
We welcome contributions! Please see our Contributing Guide for details.
$3
`bash
Clone repository
git clone https://github.com/wundr/wundr.git
cd wundr/packages/@wundr/environmentInstall dependencies
pnpm installStart development
pnpm run devRun tests
pnpm testBuild package
pnpm run build
`$3
1. Create profile template in
templates/profiles/
2. Add profile type to src/types/index.ts
3. Update ProfileManager with new profile
4. Add tests for the new profile
5. Update documentation$3
1. Extend
BaseInstaller class
2. Implement install() and validate() methods
3. Register installer in ToolManager`This project is licensed under the MIT License - see the LICENSE file for details.
- Homebrew for macOS package management
- Chocolatey for Windows package management
- NodeSource for Node.js distributions
- Anthropic for Claude AI integration
- All contributors and maintainers
---
Built with โค๏ธ by the Wundr team for the developer community.