@wundr/environment

Cross-platform development environment setup and management tools for modern software development workflows.

🚀 Features

- 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

📦 Installation

$3

``bash


Install globally

npm install -g @wundr/environment

Or use with npx

npx @wundr/environment init
`

$3

`bash


Clone the repository

git clone https://github.com/wundr/wundr.git
cd wundr/packages/@wundr/environment

Install dependencies

pnpm install

Build the package

pnpm run build

Link 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 install

Force reinstall existing tools

wundr-env install --force
`

$3

`bash


Quick validation

wundr-env validate

Detailed validation with verbose output

wundr-env validate --verbose
`

$3

`bash


Show current environment status

wundr-env status

List 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 up

Production 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 test

Run with coverage

pnpm test:coverage
`

$3

`bash


Test full environment setup

pnpm test:integration

Test 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/environment

Install dependencies

pnpm install

Start development

pnpm run dev

Run tests

pnpm test

Build 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`
4. Add platform-specific logic
5. Add comprehensive tests

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

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