# Nushell Plugins Integration (v1.0.0) - See detailed guide for complete reference\n\nFor complete documentation on Nushell plugins including installation, configuration, and advanced usage, see:\n\n- **Complete Guide**: [Plugin Integration Guide](plugin-integration-guide.md) (1500+ lines)\n- **Quick Reference**: [Nushell Plugins Guide](nushell-plugins-guide.md)\n\n## Overview\n\nNative Nushell plugins eliminate HTTP overhead and provide direct Rust-to-Nushell integration for critical platform operations.\n\n### Performance Improvements\n\n| Plugin | Operation | HTTP Latency | Plugin Latency | Speedup |\n| -------- | ----------- | -------------- | ---------------- | --------- |\n| **nu_plugin_kms** | Encrypt (RustyVault) | ~50 ms | ~5 ms | **10x** |\n| **nu_plugin_kms** | Decrypt (RustyVault) | ~50 ms | ~5 ms | **10x** |\n| **nu_plugin_orchestrator** | Status query | ~30 ms | ~1 ms | **30x** |\n| **nu_plugin_auth** | Verify session | ~50 ms | ~10 ms | **5x** |\n\n### Three Native Plugins\n\n1. **Authentication Plugin (nu_plugin_auth)**\n   - JWT login/logout with password prompts\n   - MFA enrollment (TOTP, WebAuthn)\n   - Session management\n   - OS-native keyring integration\n\n2. **KMS Plugin (nu_plugin_kms)**\n   - Multiple backend support (RustyVault, Age, Cosmian, AWS KMS, Vault)\n   - 10x faster encryption/decryption\n   - Context-based encryption (AAD support)\n\n3. **Orchestrator Plugin (nu_plugin_orchestrator)**\n   - Direct file-based operations (no HTTP)\n   - 30-50x faster status queries\n   - KCL workflow validation\n\n## Quick Commands\n\n```\n# Authentication\nauth login admin\nauth verify\nauth mfa enroll totp\n\n# KMS Operations\nkms encrypt "data"\nkms decrypt "vault:v1:abc123..."\n\n# Orchestrator\norch status\norch validate workflows/deploy.ncl\norch tasks --status running\n```\n\n## Installation\n\n```\ncd provisioning/core/plugins/nushell-plugins\ncargo build --release --all\n\n# Register with Nushell\nplugin add target/release/nu_plugin_auth\nplugin add target/release/nu_plugin_kms\nplugin add target/release/nu_plugin_orchestrator\n```\n\n## Benefits\n\n✅ **10x faster KMS operations** (5 ms vs 50 ms)\n✅ **30-50x faster orchestrator queries** (1 ms vs 30-50 ms)\n✅ **Native Nushell integration** with data structures and pipelines\n✅ **Offline capability** (KMS with Age, orchestrator local ops)\n✅ **OS-native keyring** for secure token storage\n\nSee [Plugin Integration Guide](plugin-integration-guide.md) for complete information.
