ɳSelfɳSELFDOCS
  • Getting Started

    • Introduction
    • Quick Start
    • Installation
    • Your First Project
  • Core Concepts

    • Architecture Overview
    • Project Structure
    • Configuration
    • Environments
  • Services

    • PostgreSQL Database
    • Hasura GraphQL
    • Authentication
    • Real-Time Communication
    • Storage (MinIO)
    • Email Configuration
    • Redis Cache
    • Search Engines
    • Functions
    • MLflow (ML Tracking)
    • Monitoring & Metrics
    • Admin UI
    • Dashboard
  • Database Tools

    • Schema Management
    • Migrations
    • Seeding Data
    • Backup & Restore
    • dbdiagram.io Sync
  • Microservices

    • NestJS Services
    • BullMQ Workers
    • Go Services
    • Python Services
  • CLI Reference

    • Complete Command Reference
    • Core Commands
    • Database Commands
    • Service Management
    • Production Commands
  • Deployment

    • Local Development
    • Production Setup
    • SSL/TLS Configuration
    • Domain Configuration
    • Environment Variables
  • Advanced Topics

    • Multi-Tenancy & SaaS
    • Security & Hardening
    • Custom Actions
    • Webhooks
    • Performance Tuning
    • Troubleshooting
  • ɳClaw

    • Backend Manager
    • API Gateway
    • Voice Input
    • Threads & Projects
  • Migration Guides

    • From Supabase
    • From Nhost
    • From Firebase
  • Resources

    • Changelog
    • Licensing
    • FAQ
    • Contributing
    • Support

What's New in ɳSelf


v0.9.9Updated for ɳSelf v0.9.9 - Command Tree Final Consolidation

Latest Updates - v0.9.9 (February 2026)

v0.9.9 - Command Tree Final Consolidation (30 commands)

v0.9.9 completes the command tree consolidation, reducing top-level commands from 31 to 30. The ɳSelf hasura command moves to nself db hasura, recognizing that Hasura metadata management is database-adjacent. This release also converts destroy, perf, and backup to deprecated stubs with clear migration guidance.

Command Changes:

  • 31 → 30 top-level commands: Final consolidation complete (5 Core + 16 Utilities + 9 Complex)
  • ɳSelf hasura → nself db hasura: Hasura console and metadata now under db
  • 38 deprecated stubs: All old commands still work with migration guidance until v1.0.0

Migration:

  • ɳSelf hasura console → nself db hasura console
  • ɳSelf hasura metadata apply → nself db hasura metadata apply
  • ɳSelf hasura metadata export → nself db hasura metadata export
  • ɳSelf hasura metadata reload → nself db hasura metadata reload

v0.9.8 - Production Readiness & Help Contract

v0.9.8 achieves maximum portability and production readiness with Bash 3.2 compatibility, comprehensive help contracts across all commands, and hardened CI/CD workflows. This release ensures ɳSelf works reliably on macOS, Linux, and WSL environments.

Key Achievements:

  • Bash 3.2 Compatibility: Works on macOS default shell, all Linux distros, and WSL
  • Help Contract: All 31 commands exit 0 with --help before environment checks
  • CI/CD Fail-Closed: Critical checks now fail CI on issues
  • Zero Credentials in Git: 8 credentials sanitized from repository
  • 209 Service Templates: Verified across 17 languages
  • Plugin System Verified: Stripe, Shopify, GitHub all working
  • 15/15 Verification Passing: 100% test success

Portability Improvements:

  • Removed ALL Bash 4+ dependencies (declare -A, parameter expansion)
  • Converted to Bash 3.2 compatible patterns (case statements, parallel arrays)
  • Works in restrictive/embedded environments

Update Instructions:

  • nself update - Updates to v0.9.8 (fully backward compatible)

v0.9.7 - Security & CI/CD Complete (February 8th, 2026)

v0.9.7 achieves 100% CI/CD test coverage with comprehensive security features, tenant isolation, and enterprise compliance documentation. All tests passing with production-ready security infrastructure.

Key Features:

  • 100% Test Coverage: All CI/CD tests passing across all workflows
  • Tenant Isolation: Complete RLS policies with automatic owner membership
  • Security Scanning: Shellcheck, static analysis, vulnerability detection
  • Rate Limiting & DDoS Protection: Multi-layer with configurable thresholds
  • Compliance Documentation: GDPR, HIPAA, SOC2 guides with checklists
  • Secrets Management: .env.secrets protection, vault integration, auto-rotation
  • Structured Logging: JSON output, audit trails, centralized aggregation

New Commands:

  • nself tenant compliance gdpr - GDPR compliance checklist
  • nself tenant compliance hipaa - HIPAA compliance guide
  • nself tenant compliance soc2 - SOC2 requirements
  • nself config vault init - Initialize secrets vault
  • nself logs --structured - Structured JSON logging
  • nself tenant audit - Audit trail for tenant operations

Bug Fixes:

  • Fixed JSONB value extraction in tenant settings tests
  • Fixed SQL injection vulnerabilities in vault and tenant systems
  • Fixed tenant isolation RLS chicken-and-egg issue

v0.9.6 - Command Consolidation Complete (February 5th, 2026)

v0.9.6 represents a major milestone in CLI organization, consolidating 79 top-level commands into 31 organized commands with 285+ subcommands. This 60.8% reduction dramatically improves discoverability and creates a more intuitive developer experience.

Command Structure Changes:

  • 79 → 31 Commands: Reduced top-level command count by 60.8%
  • 285+ Subcommands: Organized into logical hierarchies
  • 100% Backward Compatible: All old commands work with deprecation warnings
  • Zero Breaking Changes: Gradual migration path provided

New Organization:

  • Core (5): init, build, start, stop, restart
  • Utilities (15): status, logs, help, admin, urls, exec, doctor, monitor, health, version, update, completion, metrics, history, audit
  • Feature Commands (11): db, tenant, deploy, infra, service, config, auth, perf, backup, dev, plugin

Notable Changes:

  • cloud → provider: Renamed to avoid naming conflicts
  • Hierarchical Subcommands: tenant, deploy, infra, service, config, auth, perf, backup, dev
  • Modernized Help System: Consistent formatting, color coding, clear examples
  • Deprecation Warnings: Helpful migration messages for old commands

Migration:

All old commands continue to work and display migration guidance. Old commands will be removed in v1.0 (estimated Q2 2026) with 6-month advance notice.

Deprecation Example

$ nself billing plans
⚠️  DEPRECATION: 'billing' command is deprecated
➜  Use: nself tenant billing plans
➜  Old syntax will be removed in v1.0 (estimated Q2 2026)
[command continues to execute normally]

Previous Major Releases

v0.4.8 - Plugin System Release (January 24th, 2026)

v0.4.8 introduces the plugin system, enabling third-party integrations with payment processors, e-commerce platforms, DevOps tools, and more. Plugins provide database schemas, webhook handlers, CLI commands, and analytics views.

New Features:

  • Plugin System: Extensible architecture for third-party integrations
  • Plugin Registry: Centralized registry at plugins.nself.org with global edge distribution
  • 3 Official Plugins: Stripe, GitHub, and Shopify plugins available at launch
  • Plugin CLI Commands: nself plugin install, nself plugin list, nself plugin update
  • Custom Plugin Development: Create your own plugins with nself plugin create
  • Webhook Handlers: Automatic webhook endpoint configuration and signature verification
  • Database Integration: Plugin tables automatically tracked in Hasura with GraphQL access

Available Plugins:

  • Stripe (v1.2.0): Payment processing, subscriptions, invoices, and revenue analytics
  • GitHub (v1.3.0): Repository sync, issues, PRs, Actions, and workflow statistics
  • Shopify (v1.1.0): Products, orders, customers, inventory, and sales analytics

v0.4.7 - QA Complete Release (January 23rd, 2026)

v0.4.7 completes 7 QA rounds with all 8 bugs fixed. Cloud infrastructure commands work on all platforms including macOS with Bash 3.2 compatibility.

v0.4.6 - Performance & Benchmarking (January 22nd, 2026)

Performance profiling and benchmarking tools: nself perf, nself bench, nself scale, nself history.

v0.4.5 - Cloud Provider Expansion (January 21st, 2026)

26 cloud providers supported with unified commands: nself provider (formerly cloud), nself provider server, nself provider cost.

v0.4.4 - Database Tools (January 20th, 2026)

Complete nself db command suite: schema, migrate, seed, backup, restore, inspect, types, shell, query.

v0.4.3 - Deployment Pipeline (January 19th, 2026)

Multi-environment workflow: nself env, nself deploy, nself staging, ɳSelf prod with secrets management.

v0.4.2 - Service & Monitoring (January 18th, 2026)

6 new commands: nself email, nself search, nself functions, nself mlflow, nself metrics, nself monitor.

v0.4.1 - Platform Compatibility (January 17th, 2026)

Critical platform compatibility fixes for macOS and Linux cross-platform support.

v0.4.0 - Production Ready (October 13th, 2025)

Production-ready milestone with 36 CLI commands, 40+ service templates, and comprehensive CI/CD testing.


Stay Updated

Check nself.org/releases for detailed release notes and GitHub Releases for complete changelogs.