Skip to content
Β 
Β 

Latest commit

Β 

History

208 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PSPredictor

PowerShell Universal CLI Predictor

πŸš€ Revolutionary PowerShell Binary Module transforming your terminal into a comprehensive IDE experience

Build Status PowerShell Gallery License Stars

⚠️ MAJOR VERSION TRANSITION: PSPredictor v2.0 is a complete rewrite from PowerShell scripts to a high-performance C# .NET 9.0 binary module with AI-powered intelligence and IDE-like features.

πŸ“š Legacy Version Reference

Looking for PSPredictor v1.x? The previous PowerShell script-based version is available at: πŸ“– PSPredictor v1.x Documentation

Migration Path: v1.x users can upgrade to v2.0 for significantly improved performance, AI-powered intelligence, and native cross-platform support. See our migration guide for detailed transition instructions.


πŸš€ Quick Start

What is PSPredictor?

PSPredictor v2.0 is a revolutionary C# .NET 9.0 binary module that transforms PowerShell into an intelligent, IDE-like terminal experience with:

  • 🧠 AI-Powered Intelligence: ML.NET integration with local models for intelligent command prediction
  • ⚑ Native Performance: <50ms response time with <20MB memory footprint
  • 🎨 Real-time Syntax Highlighting: PowerShell and CLI tool syntax coloring as you type
  • πŸ”§ 26+ CLI Tool Support: Git, Docker, Kubernetes, Azure CLI, AWS CLI, and more
  • πŸ“ Advanced Editing Modes: Cmd, Emacs, and Vi modes with customizable key bindings

Installation

# Install from PowerShell Gallery (recommended)
Install-Module PSPredictor -Scope CurrentUser

# Import and enable
Import-Module PSPredictor
Enable-PSPredictor

# Verify installation
Get-PSPredictorStatus

Try It Now

# Experience intelligent completions
git <TAB>           # See Git commands with descriptions
docker run <TAB>    # Get container options and image suggestions
kubectl get <TAB>   # Explore Kubernetes resources

# Configure your preferences
Set-PSPredictorMode -EditingMode Emacs  # or Vi, Cmd
Set-PSPredictorKeyBinding -Key "Ctrl+Space" -Function "TriggerIntelliSense"

Immediate Benefits:

  • βœ… Intelligent completions for Git, Docker, PowerShell, and more
  • βœ… Real-time syntax highlighting and error detection
  • βœ… AI-powered command suggestions based on your usage patterns
  • βœ… Enhanced editing experience with multiple modes

πŸ“– Documentation

For comprehensive documentation, configuration guides, and advanced usage examples, see our complete documentation:

πŸ“š Complete User Guide & Documentation β†’

Quick Links

Architecture & Development

Legacy Support


✨ Key Features

🧠 AI-Powered Intelligence

  • Local ML Models: Embedded ML.NET models for instant, offline functionality
  • Context-Aware Suggestions: Understands Git state, Docker environment, Kubernetes cluster
  • Predictive IntelliSense: Non-intrusive completion suggestions that appear as you type
  • Continuous Learning: Learns from your usage patterns to improve suggestions

🎨 IDE-Like Terminal Experience

  • Real-time Syntax Highlighting: PowerShell and CLI tool syntax coloring
  • Visual Error Indication: Immediate feedback on syntax errors and invalid commands
  • Multi-line Editing: Advanced editing with proper indentation and formatting
  • Dynamic Help System: Context-sensitive help without leaving the command line

⚑ Native Performance

  • <50ms Response Time: Lightning-fast completions powered by optimized C# code
  • <20MB Memory Footprint: Efficient resource usage for everyday productivity
  • Cross-Platform: Full Windows, Linux, and macOS support (including ARM64)
  • Lazy Loading: Components load on-demand for optimal startup performance

πŸ”§ Comprehensive CLI Tool Support

  • 26+ Popular Tools: Git, Docker, Kubernetes, Azure CLI, AWS CLI, npm, and many more
  • Context-Aware Completions: Understanding of tool state and environment
  • Dynamic Parameters: Intelligent parameter suggestions based on command context
  • Cross-Tool Intelligence: Understands relationships between different tools

πŸ› οΈ System Requirements

Supported Platforms

  • βœ… Windows: 10/11, Server 2019/2022 (PowerShell 5.1+ or Core 7.0+)
  • βœ… Linux: Ubuntu 20.04+, RHEL 8+, Debian 11+ (PowerShell Core 7.0+)
  • βœ… macOS: 11.0+ including Apple Silicon M1/M2/M3 (PowerShell Core 7.0+)

Prerequisites

  • .NET Runtime: .NET 9.0+ (included with PowerShell 7.4+)
  • Architecture: x64 and ARM64 fully supported
  • Dependencies: Self-contained, no additional dependencies required

🀝 Community & Support

Getting Help

Contributing

Distribution


πŸ“‹ Performance Specifications

Response Time Targets

  • ⚑ Completion Generation: <50ms for standard completions
  • 🧠 AI Predictions: <100ms for ML-powered suggestions
  • 🎨 Syntax Highlighting: <20ms for real-time coloring
  • πŸ“ Multi-line Rendering: <30ms for complex command structures

Memory Efficiency

  • πŸš€ Startup Footprint: <20MB initial memory usage
  • πŸ’Ύ Runtime Footprint: <50MB for typical usage patterns
  • πŸ€– Model Loading: Lazy loading with <5MB core embedded models
  • πŸ“š History Management: SQLite with automatic cleanup and archiving

πŸš€ Made with ❀️ and AI for the PowerShell community

Transform your terminal into an intelligent, IDE-like experience with PSPredictor v2.0

License: MIT License - see LICENSE file
Copyright: Β© 2024-2025 PSPredictor Contributors

πŸ“‹ Report Bug Β· πŸ’‘ Request Feature Β· 🀝 Contribute Β· πŸ“š Documentation Β· πŸ—οΈ Architecture

About

PowerShell Universal CLI Predictor - Comprehensive auto-completion and prediction for popular command-line tools

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages