npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

@chude/ai-dev-environment

v4.8.1

Published

Production-grade development environment for AI developers working with Claude Code and AI tools. Features intelligent navigation, automated project discovery, comprehensive validation, and enterprise-ready reliability.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

chudechude

Keywords

aiclaudeclaude-codedevelopmentproductivitymcpnavigationaliasesbashshelldeveloper-toolscliworkspaceproject-managementai-tools

Readme

AI Dev Environment v4.6.4

npm version Tests Coverage Production Ready License

Production-grade development environment for AI developers working with Claude Code and AI tools. Features intelligent navigation, automated project discovery, comprehensive validation, and reliability.

Features

Navigation System (go-* pattern)

  • Instant navigation: Jump to any project with go-projectname
  • Dynamic discovery: Find and add projects automatically
  • Extensible design: Add new projects and aliases on the fly
  • Cross-session persistence: Aliases survive between sessions

Development Tools

  • Project management: Discover, add, and organize projects
  • Quick operations: Start, test, and build projects with simple commands
  • Memory system integration: Works with CLAUDE.md and MCP-Nexus
  • Git integration: Quick git commands with short aliases

AI-First Design

  • Claude Code ready: Optimized for use with Claude Code sessions
  • MCP compatible: Integrates with Model Context Protocol servers
  • Memory aware: Designed to work with AI memory systems

Production Features

Core Capabilities

  • Performance monitoring: Real-time metrics, benchmarking, and optimization
  • Version management: Semantic versioning with upgrade path validation
  • Context-aware intelligence: Smart suggestions based on current project
  • Backup and recovery: Full backup, restore, and history tracking
  • Universal platform support: WSL2, Linux, macOS - one config works everywhere
  • Comprehensive testing: 543 tests, 100% pass rate
  • Smart discovery: Auto-detect and configure projects automatically
  • Lazy loading: Sub-100ms startup times, <15MB memory footprint
  • Security hardened: Input validation, path traversal protection, injection prevention

WoW (Ways of Working) Enforcement System

Adaptive compliance engine for Claude Code that enforces development best practices through intelligent hooks, behavioral tracking, and predictive intelligence.

v3.5.0 Features:

  • Context-aware intelligence: Smart suggestions based on current context and history
  • Consequence oracle: Predictive impact analysis before operations (planned)
  • Persistent memory: Decision tracking across sessions (in progress)
  • Override system: Intelligent override capabilities for justified exceptions

Core Features:

  • File proliferation prevention: Blocks creation of new files, enforces editing existing ones
  • Real-time scoring: Tracks compliance with 0-100 score and letter grades (A+ to F)
  • Behavioral adaptation: Progressive responses based on violation history
  • Auto-fix capabilities: Automatically corrects git commits (removes emojis, adds author)
  • Root folder protection: Whitelist-based protection for clean project structure
  • Gamification: Streak tracking, trust levels, and positive reinforcement
  • Cognitive friction: Progressive delays for repeated violations
  • Session reports: Comprehensive compliance summary at session end

How It Works:

  1. PreToolUse Hooks: Intercept and validate/block Write, Edit, and Bash operations
  2. State Management: Persistent tracking in /tmp/.wow-state/
  3. Smart Context Detection: Allows temp files, enforces root whitelist
  4. Command Rewriting: Auto-fixes non-compliant git commands
  5. Progressive Education: First violation teaches, repeated violations increase friction

Consolidated Architecture (v3.5.0):

  • Single Source of Truth: All WoW configuration in /mnt/c/Users/[username]/.claude/
  • Unified Access: Both /root/.claude and /home/[username]/.claude symlink to central location
  • No File Duplication: All scripts, settings, and state in one place

Quick Start

npm Installation (Recommended)

Install with npm:

npm install -g @chude/ai-dev-environment

Restart your shell or run source ~/.bashrc to activate.

Alternative: GitHub One-Liner

Install directly from GitHub (no Node.js required):

curl -fsSL https://raw.githubusercontent.com/chudeemeke/AI-Dev-Environment/main/install | bash

Manual Installation

For more control or offline installation:

Clone and Install:

git clone https://github.com/chudeemeke/AI-Dev-Environment.git ~/Projects/AI-Dev-Environment
cd ~/Projects/AI-Dev-Environment

# Standard installation
bash scripts/install.sh -g

# Fast mode (instant output)
bash scripts/install.sh -g --fast

# Activate
source ~/.bashrc

Installation Options:

  • -g or --global: Global installation (adds to ~/.bashrc) - Required
  • --fast: Skip comfortable delays (instant output) - Optional
  • --unattended: Non-interactive mode for CI/CD - Optional

For PowerShell:

git clone https://github.com/yourusername/AI-Dev-Environment.git
cd AI-Dev-Environment
.\scripts\install.bat
# Restart PowerShell or run:
. $PROFILE

Manual WSL2 Setup (if aliases don't load):

# Source the bash loader directly
source /mnt/c/Users/$USER/iCloudDrive/Documents/AI\ Tools/Anthropic\ Solution/Projects/AI-Dev-Environment/src/loaders/bash-loader.sh

# Make it permanent
echo 'source /mnt/c/Users/$USER/iCloudDrive/Documents/AI\ Tools/Anthropic\ Solution/Projects/AI-Dev-Environment/src/loaders/bash-loader.sh' >> ~/.bashrc

Developer Setup (Contributors)

For active development, use a symlink installation that points directly to your development repository:

# Clone the repository
git clone https://github.com/chudeemeke/AI-Dev-Environment.git ~/Projects/AI-Dev-Environment
cd ~/Projects/AI-Dev-Environment

# Create symlink to dev repo (instead of copying files)
rm -rf ~/.ai-dev-env  # Remove existing installation if any
ln -sf ~/Projects/AI-Dev-Environment ~/.ai-dev-env

# Install (will detect symlink and preserve it)
bash scripts/install.sh -g

# Activate
source ~/.bashrc

Why use symlink for development?

  • Changes to source files are immediately active (no reinstall needed)
  • VERSION file is the single source of truth (local version always matches npm publish)
  • Standard git workflow (branch, commit, push)
  • Uninstall removes symlink only, preserves your dev repo

Verify developer mode:

ls -la ~/.ai-dev-env
# Should show: .ai-dev-env -> /path/to/your/AI-Dev-Environment

aidev --version
# Should match: cat VERSION

Switching between modes:

# End user mode (standard install)
rm ~/.ai-dev-env
bash scripts/install.sh -g

# Developer mode (symlink)
rm -rf ~/.ai-dev-env
ln -sf ~/Projects/AI-Dev-Environment ~/.ai-dev-env
bash scripts/install.sh -g

How It Works

The system uses a central JSON configuration (config/aliases.json) that gets loaded by environment-specific loaders:

  • WSL2/Linux: src/loaders/bash-loader.sh
  • PowerShell: src/loaders/powershell-loader.ps1
  • Git Bash: Uses bash-loader.sh

This means you can update aliases in one place and they work everywhere!

WoW Enforcement Configuration

The WoW enforcement system is configured via Claude Code settings.json files:

Configuration Files

  • Primary: ~/.claude/settings.json (Linux/Mac/WSL2)
  • Windows: /mnt/c/Users/[username]/.claude/settings.json

Enabling WoW Enforcement

# The system includes several enforcement scripts:
./scripts/wow-enforcer.sh        # Quick compliance check
./scripts/wow-session-tracker.sh # Detailed scoring and audit
./scripts/wow-quick-check.sh     # Silent monitoring

WoW Principles Enforced

  1. Edit > Create: Blocks new file creation, enforces editing existing files
  2. No Sycophancy: Continuous reminders to challenge poor decisions
  3. Defend Architecture: Prompts to stand by good design decisions
  4. Root Folder Protection: Only whitelisted files allowed in root
  5. Git Standards: Auto-fixes author and removes emojis
  6. Documentation Updates: Reminds to update docs with every change
  7. Precise Execution: Tracks and scores adherence to requirements

Monitoring Compliance

# Check current WoW score
cat /tmp/.wow-state/score

# View violation history
cat /tmp/.wow-state/audit.log

# Run full compliance audit
./scripts/wow-session-tracker.sh

Basic Usage

Navigation

# Go to a project
go-nexus         # Navigate to MCP-Nexus
go-marketplace   # Navigate to MCP-Marketplace
go-jarvis        # Navigate to JARVIS-MCP

# List all navigation aliases
list-go

Adding New Projects

# Add a simple navigation alias
add-go-alias myproject "/path/to/myproject"

# Add a complete project with npm operations
add-project voice "Voice-Assistant-System"

# Discover projects automatically
discover-projects

Making Changes Permanent

# Save your new aliases
save-aliases

# Reload to use immediately
source ~/.bashrc

Project Structure

AI-Dev-Environment/
├── README.md                   # This file
├── install.sh                  # Unix/Mac installer
├── install.bat                 # Windows installer
├── src/
│   ├── aliases/
│   │   ├── navigation.sh       # go-* navigation aliases
│   │   ├── operations.sh       # Operation aliases
│   │   ├── utilities.sh        # Utility functions
│   │   └── git.sh              # Git shortcuts
│   ├── functions/
│   │   ├── project-manager.sh  # Project management functions
│   │   ├── discovery.sh        # Project discovery
│   │   ├── persistence.sh      # Save/load functionality
│   │   └── help.sh             # Help system
│   └── config/
│       ├── defaults.sh         # Default configuration
│       └── user.sh             # User overrides
├── docs/
│   ├── EXTENDING.md            # How to extend the system
│   ├── INTEGRATION.md          # Integration with other tools
│   └── TROUBLESHOOTING.md      # Common issues and solutions
├── examples/
│   ├── custom-aliases.sh       # Example custom aliases
│   └── project-templates/      # Project templates
└── tests/
    └── test-aliases.sh         # Test suite

Core Concepts

The go-* Pattern

The go-* pattern makes navigation intuitive and discoverable:

  • go- prefix indicates navigation
  • Tab completion shows all available destinations
  • Consistent and memorable

Dynamic Management

Add aliases without editing files:

add-go-alias trinity "/path/to/Trinity"
save-aliases

Project Discovery

Automatically find projects:

discover-projects
# Suggests aliases for all projects without one

Extensibility

Designed to grow with your needs:

  • Add custom functions
  • Create project templates
  • Build automation tools

Advanced Usage

Custom Project Templates

Create templates for different project types:

# Add a Python project
add-python-project mlops "ML-Ops-Platform"

# Add a React project
add-react-project dashboard "Analytics-Dashboard"

Batch Operations

Operate on multiple projects:

# Update all npm projects
update-all-npm

# Run tests across projects
test-all-projects

Integration with AI Tools

Claude Code

Tell Claude in new sessions:

Please source ~/.bashrc and use the go-* navigation system

MCP Servers

Navigate to MCP servers quickly:

go-memory      # Memory-Nexus server
go-filesystem  # Filesystem-Nexus server

Configuration

Environment Variables

# Project root directory
export PROJECTS_ROOT="/path/to/your/projects"

# Claude home directory
export CLAUDE_HOME="$HOME/.claude"

# MCP Nexus location
export MCP_NEXUS_ROOT="$PROJECTS_ROOT/MCP-Nexus"

Customization

Edit ~/.ai-dev-env/config/user.sh to customize:

  • Default paths
  • Alias patterns
  • Operation commands

Publishing Workflow (For Maintainers)

This project uses an Apple-style integrated release workflow with zero mental overhead.

Simple Release (Recommended)

aidev release

What it does:

  1. Interactive prompts guide you through the release
  2. Bumps version (patch/minor/major)
  3. Optional CHANGELOG update
  4. Creates git commit + tag
  5. Pushes to GitHub (triggers CI)
  6. Monitors CI tests automatically
  7. Prompts for OTP when ready
  8. Publishes to npm

One command. Zero configuration. It just works.

Quick Releases

aidev release patch   # Bug fixes
aidev release minor   # New features
aidev release major   # Breaking changes

No prompts - instant release creation. Publish later with aidev publish.

Manual Publish

aidev publish

Publishes the most recent release. Useful if you skipped publishing during aidev release.

Advanced Options

Option 1: Direct Script (For Automation)

./scripts/publish-watch.sh vX.Y.Z

Features:

  • Automatically finds and monitors CI workflow
  • Detects if workflow already completed
  • Checks test results before prompting for OTP
  • 3-attempt retry for invalid/expired OTP codes
  • Skips duplicate publish if already on npm
  • Comprehensive edge case handling

Option 2: GitHub UI Workflow (Mobile-Friendly)

  1. Navigate to Actions → "Publish to npm (Manual)"
  2. Click "Run workflow"
  3. Enter your 6-digit OTP from authenticator
  4. Click "Run workflow" button

Use when publishing from mobile or away from terminal.

CI/CD Pipeline

Every tag push triggers:

  1. Run Tests - Full test suite (542/542 tests must pass)
  2. Publish to npm - Requires manual OTP input (2FA security)
  3. Create GitHub Release - Automatic release notes

View workflow: .github/workflows/release.yml

Apple Philosophy in Action

Simple Interface:

  • aidev release - One command for common case
  • aidev publish - One command for edge case

Hidden Complexity:

  • Version bumping, git operations, CI monitoring, OTP handling - all automatic
  • Intelligent workflow detection, retry logic, edge case handling - invisible to user

It Just Works:

  • No version numbers to remember (auto-detected)
  • No manual git commands (automated)
  • No workflow IDs to find (auto-discovered)
  • No failed publishes (retry logic)

The workflow feels magical because complexity is hidden, not removed.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Areas for Contribution

  • New project templates
  • Additional utility functions
  • Integration with more AI tools
  • Documentation improvements

Troubleshooting

Aliases Not Working

# Check if aliases are loaded
alias | grep go-

# Reload configuration
source ~/.bashrc

Permission Issues

# Make scripts executable
chmod +x install.sh
chmod +x src/**/*.sh

Future Roadmap

  • [ ] VSCode integration
  • [ ] Project templates marketplace
  • [ ] AI-powered project suggestions
  • [ ] Cross-platform PowerShell support
  • [ ] Project health monitoring
  • [ ] Automated dependency updates

License

MIT License - see LICENSE file for details.

Acknowledgments

Created as part of the AI development ecosystem for enhancing productivity with Claude Code and MCP servers.

Pro Tip: After installation, type alias-help for a quick reference of all available commands!

Test Line for Hook Verification

This line was added to test WoW enforcement hooks.

🤖 CI/CD Auto-Fix

This repository uses Claude AI to automatically fix CI/CD failures. If builds fail, Claude will automatically create a fix PR.