Skip to content

nself cli v0.3.3

Choose a tag to compare

@acamarata acamarata released this 14 Aug 00:26

⏺ 🚀 nself v0.3.3 - Intelligent Auto-Fix System

Release Date: August 14, 2025

🎯 Highlights

nself just got smarter! This release transforms how nself handles issues - it now automatically fixes problems by default, making your development workflow smoother and more reliable. No more manual interventions for common issues!


✨ What's New

🤖 Automatic Fixing is Now Default

  • ALWAYS_AUTOFIX=true is the new default behavior
  • System intelligently resolves configuration issues without prompting
  • Up to 30 automatic retry attempts ensure robust problem resolution
  • Concise, inline status updates keep you informed without clutter
  • Need control? Set ALWAYS_AUTOFIX=false for interactive mode

🧹 Docker Resource Management

New Command: nself clean

  • Clean up Docker resources with surgical precision
  • Remove project images, containers, volumes, and networks
  • Smart detection prevents accidental deletion of unrelated resources
  • Proper image tagging eliminates duplicate buildup
  • See disk space reclaimed instantly

🏗️ Comprehensive Service Auto-Generation

  • Missing service? No problem! nself creates it automatically
  • Full support for NestJS, BullMQ, Go, and Python services
  • Complete hello-world implementations with production-ready Dockerfiles
  • Seamless continuation - no manual intervention needed
  • Smart type detection from directory structure

🔌 Advanced Port Conflict Resolution

  • Proactive port checking before Docker even starts
  • Interactive numbered menu for manual resolution
  • Automatic port reassignment in auto-fix mode
  • Intelligent port mapping for Redis, Mailpit, PostgreSQL, and more
  • No more cryptic "port already in use" errors

🛠️ Improvements

Build System Enhancements

  • ✅ Silent failures now properly report errors
  • ✅ Fully idempotent build command
  • ✅ Graceful handling of partial builds
  • ✅ Validation runs in isolated subshell

Service Reliability

  • ✅ Automatic recovery from unhealthy services
  • ✅ Missing Dockerfile detection and generation
  • ✅ Go module dependency auto-resolution
  • ✅ Continuous retry mechanism for transient failures

Professional Output

  • ✅ Lowercase headers following nself design standards
  • ✅ Compact status indicators (✓, ⚡, ⠋, ✗)
  • ✅ Cleaner, more readable terminal output
  • ✅ CI/CD-friendly verbose reduction

📚 Usage Examples

Just works! Auto-fixes everything by default

nself up

Need manual control? Use interactive mode

ALWAYS_AUTOFIX=false nself up

Clean up Docker resources

nself clean # Remove images and build cache
nself clean -a # Nuclear option - clean everything
nself clean -c -i # Clean containers and images only

Your typical workflow is now even simpler

nself init myproject
cd myproject
nself build # Idempotent - run it anytime
nself up # Auto-fixes any issues and starts


🔄 Migration Guide

Good news: No breaking changes!

Your existing projects will automatically benefit from the new auto-fix capabilities. If you prefer the previous interactive behavior:

Add to your .env.local

ALWAYS_AUTOFIX=false


📊 By The Numbers

  • 30 maximum auto-fix retry attempts
  • 4 service types auto-generated (NestJS, BullMQ, Go, Python)
  • 22+ types of issues automatically resolved
  • 1 command to clean all Docker resources
  • 0 manual interventions needed for common issues

🙏 Acknowledgments

Thanks to our community for the feedback that shaped this release. Your real-world usage scenarios helped us identify and automate the most common pain points.


📦 Installation

New installation

curl -fsSL https://get.nself.org | bash

Update existing installation

nself update


📝 Full Changelog

See https://github.com/nself/nself/blob/main/docs/CHANGELOG.MD for complete technical details.


Ready to experience the new intelligent nself? Update now and let the system handle the complexity while you focus on building great applications!