-
-
Notifications
You must be signed in to change notification settings - Fork 2
v0.9.9
Release Date: March 15, 2026 Type: Bug Fix & Stability Release Status: Release Candidate ✅
v0.9.9 is the final stabilization release before v1.0 LTS. It ships with no new features — only targeted bug fixes across the CLI, the Pro plugin ecosystem, and the nclaw showcase apps.
nself status — service detail lookup failure
show_service_detail built container names with hyphens (e.g. nself_node-exporter) but Docker Compose converts hyphens to underscores when naming containers (nself_node_exporter). The lookup always failed for hyphenated service names. Fixed by converting hyphens with ${service_name//-/_}.
nself logs — crash when PROJECT_NAME is not set
format_service_name used bare ${PROJECT_NAME} in prefix-strip patterns. With set -u active, referencing this variable before export caused an immediate crash. Fixed with ${PROJECT_NAME:-nself} defaults.
nself status — shows 0/N running for non-default project names
When a project was started with a custom COMPOSE_PROJECT_NAME, the status command reported all services as stopped because the container name prefix didn't match. Both issues above contributed to this symptom.
nself ssl delegation — nself ssl now correctly delegates to nself auth ssl.
All nine nclaw Rust plugins (notify, cron, google, mux, ai, claw, voice, browser, livekit) compile clean under SQLX_OFFLINE=true with zero errors.
nself-ai — sqlx::query! macros in usage.rs had stale .sqlx/ cache hashes that diverged after query updates. Converted both record_fallback and monthly_spend to runtime sqlx::query() to remove the CI dependency on regenerated cache files.
nself-google — AccountInfo struct was missing #[derive(serde::Serialize)], causing an into_response() compile error in the account info endpoint. Derive added.
nself-mux — CalendarSync and DonorAction variants were added to RuleAction in rules.rs but the match arm in gmail_history.rs was not updated, producing a non-exhaustive match compile error. Both arms added.
nself-voice — Claw health check now has a 3-second timeout to prevent indefinite blocking at startup. Session and recording data is now written to the database on call completion. Migration adds call_sid UNIQUE, from_number, and status columns.
nself-browser — Session records are written to np_browser_sessions after each screenshot, scrape, and pdf operation. Columns: url, operation, status, error, duration_ms, source_account_id.
nself-cron — Schedule validation runs before INSERT (invalid cron expressions return HTTP 400 instead of writing a broken job). list_jobs_for_account returns only jobs owned by the requesting account. source_account_id stored on all job records.
Coverage workflow schema mismatch — the psql schema setup step in coverage.yml was creating tables with outdated column definitions. Updated to match live migration output:
-
np_jobs: addedsource_account_id TEXT NOT NULL DEFAULT 'default' -
np_voice_sessions: addedcall_sid TEXT UNIQUE,from_number TEXT,status TEXT NOT NULL DEFAULT 'active' -
np_browser_sessions: columns replaced to match new migration schema
Calendar recurrence — day-of-week timezone bug — check.getDay() returns the day of week in the local timezone. ISO date strings parsed with new Date('YYYY-MM-DD') are UTC midnight, which shifts to the prior calendar day in UTC−4/−5. Fixed with getUTCDay() throughout the weekly recurrence check.
Key rotation — DST boundary — US Daylight Saving Time (March 8, 2026) caused a 30-day key age check to return false on day 30 because the raw millisecond difference was ~29.96 days. Fixed by truncating both timestamps to UTC midnight before computing the day delta.
nself update
# or reinstall from scratch:
curl -fsSL https://install.nself.org | bashIf the plugin registry returns an empty list after updating, clear the local cache:
rm -f ~/.nself/cache/plugin-registry.json
nself plugin refresh
nself plugin listPro plugins use short IDs, not the Rust crate names:
nself license set <your-license-key>
nself plugin install notify cron google mux ai claw
# Max tier only:
nself plugin install voice browserv1.0.0 is the stable, long-term-support release. It follows v0.9.9 once the release candidate has been validated in production for at least two weeks with no critical issues.
ɳSelf CLI v1.0.9. MIT licensed. Docs CC BY 4.0.
GitHub · Issues · Discussions · nself.org · nself.org/docs
Getting Started
Commands
- Commands, Overview
- Lifecycle: cmd-init · cmd-build · cmd-start · cmd-stop · cmd-restart · cmd-dev
- Monitoring: cmd-status · cmd-logs · cmd-health · cmd-urls · cmd-doctor · cmd-monitor · cmd-alerts · cmd-sentry · cmd-watchdog
- Data: cmd-db · cmd-backup · cmd-dr · cmd-queue · cmd-webhooks
- Config: cmd-config · cmd-service · cmd-env · cmd-promote
- Networking: cmd-ssl · cmd-trust · cmd-dns-setup
- Security: cmd-access · cmd-security · cmd-secrets
- Tenancy: cmd-tenant · cmd-billing
- Plugins: cmd-plugin · cmd-license · cmd-dogfood (extracted, CLI-R11) · cmd-k8s (extracted, CLI-R11) · cmd-encryption (extracted, CLI-R11) · cmd-waf (extracted, CLI-R11) · cmd-federation (extracted, CLI-R11) · cmd-mail (extracted, CLI-R11) · cmd-dlq (extracted, CLI-R11)
- AI: cmd-ai · cmd-claw · cmd-model
- Templates: cmd-template
- Utilities: cmd-exec · cmd-clean · cmd-reset · cmd-update · cmd-upgrade · cmd-version · cmd-admin · cmd-migrate · cmd-migrate-firebase · cmd-migrate-supabase · cmd-completion
Features
- Features, Overview
- Feature-Auth
- Feature-Storage
- Feature-Search
- Feature-Functions
- Feature-Email
- Feature-Monitoring
- Feature-Plugins
- Feature-nClaw, AI Assistant
- Feature-nChat, Messaging
- Feature-nTV, Media Player
- Feature-nFamily, Family Social
- Feature-nCloud, Managed Hosting
- Feature-Memory-Rooms, Knowledge Organization
- Feature-Agent-Dashboard, Agent Metrics
- Feature-Image-Generation, AI Image Generation
Configuration
- Configuration, Overview
- Config-Env-Vars
- Config-Postgres
- Config-Hasura
- Config-Auth
- Config-Nginx
- Config-Optional-Services
- Config-Custom-Services
- Config-System
Plugins (87 + 10 monitoring)
Free (25)
- plugin-backup
- plugin-content-acquisition
- plugin-content-progress
- plugin-cron
- plugin-donorbox
- plugin-feature-flags
- plugin-github
- plugin-github-runner
- plugin-invitations
- plugin-jobs
- plugin-link-preview
- plugin-mdns
- plugin-mlflow
- plugin-monitoring
- plugin-notifications
- plugin-notify
- plugin-paypal
- plugin-search
- plugin-shopify
- plugin-stripe
- plugin-subtitle-manager
- plugin-tokens
- plugin-torrent-manager
- plugin-vpn
- plugin-webhooks
Pro (62)
- plugin-access-controls
- plugin-activity-feed
- plugin-admin-api
- plugin-nself-ai-gateway
- plugin-nself-ai-mcp
- plugin-nself-ai-mcp
- plugin-analytics
- plugin-auth
- plugin-backup-pro
- plugin-bots
- plugin-browser
- plugin-calendar
- plugin-cdn
- plugin-chat
- plugin-claw
- plugin-claw-budget
- plugin-claw-news
- plugin-claw-web
- plugin-cloudflare
- plugin-cms
- plugin-compliance
- plugin-cron-pro
- plugin-ddns
- plugin-devices
- plugin-documents
- plugin-donorbox-pro
- plugin-entitlements
- plugin-epg
- plugin-file-processing
- plugin-game-metadata
- plugin-geocoding
- plugin-geolocation
- plugin-google
- plugin-home
- plugin-idme
- plugin-knowledge-base
- plugin-linkedin
- plugin-livekit
- plugin-media-processing
- plugin-meetings
- plugin-moderation
- plugin-mux
- plugin-notify-pro
- plugin-object-storage
- plugin-observability
- plugin-paypal-pro
- plugin-photos
- plugin-podcast
- plugin-post
- plugin-realtime
- plugin-recording
- plugin-retro-gaming
- plugin-rom-discovery
- plugin-shopify-pro
- plugin-social
- plugin-sports
- plugin-stream-gateway
- plugin-streaming
- plugin-stripe-pro
- plugin-support
- plugin-tmdb
- plugin-voice
- plugin-web3
- plugin-workflows
Planned (26)
plugin-auditplugin-blogplugin-checkoutplugin-commerceplugin-drmplugin-exportplugin-flowplugin-importplugin-ldapplugin-mailgunplugin-mediaplugin-oauth-providersplugin-pagesplugin-postmarkplugin-rate-limitplugin-reportsplugin-samlplugin-schedulerplugin-sendgridplugin-ssoplugin-subscriptionplugin-thumbplugin-transcoderplugin-twilioplugin-wafplugin-watermark
Guides
- Guide-Production-Deployment
- Guide-SSL-Setup
- Guide-Multi-Tenancy
- Guide-Security-Hardening
- Guide-Monitoring-Setup
- Guide-Backup-Restore
- Guide-Custom-Services
- Guide-Migration-from-v1
Architecture
Reference
- API-Reference
- error-codes, Error Codes
Licensing
Security
Brand
Operations
- operations/release-cascade, Release Cascade
- operations/self-healing, Self-Healing Schema
- operations/redis-tuning, Redis Pool Tuning
- operations/meilisearch-warmup, MeiliSearch Warm-Up
- operations/jwt-rotation, JWT Key Rotation
- operations/windows-wsl2-setup, Windows / WSL2 Setup
- operations/gemini-oauth-reauth, Gemini OAuth Reauth
Contributing
Admin
- USER-ACTION-QUEUE, Pending Admin Actions
All commands (52)
- A: cmd-access · cmd-account · cmd-admin
- B: cmd-backup · cmd-build · cmd-bundle
- C: cmd-ci · cmd-clean · cmd-completion · cmd-config
- D: cmd-db · cmd-deploy · cmd-dev · cmd-doctor
- E: cmd-env · cmd-exec
- F: cmd-functions
- G: cmd-generate
- H: cmd-health · cmd-help-topics
- I: cmd-init · cmd-install
- L: cmd-license · cmd-login · cmd-logout · cmd-logs
- M: cmd-man · cmd-mcp · cmd-migrate
- O: cmd-oauth · cmd-ops
- P: cmd-plugin · cmd-promote
- R: cmd-remove · cmd-reset · cmd-restart · cmd-runner
- S: cmd-secrets · cmd-security · cmd-self-heal · cmd-server · cmd-service · cmd-start · cmd-status · cmd-stop
- T: cmd-telemetry · cmd-template · cmd-trust
- U: cmd-update · cmd-urls
- V: cmd-verify-sbom · cmd-version