PromptShell

Wish your terminal understood everyday language? 💡
Tired of switching tabs to look up shell commands on ChatGPT?

Introducing...

>_ PromptShell

Your Smart Terminal Assistant that translates natural language commands into precise shell commands with context awareness, making CLI operations smooth and secure.

Linux | macOS | Windows

⚡ Redefine Your Terminal Experience

• 🧠Natural Language to Shell Commands: Converts plain English queries into accurate shell commands.

• 🖥️OS agnostic: Works seamlessly across Windows, Linux, and macOS.

• 🤖Hybrid AI-Model Support: Run offline locally with Ollama for privacy or integrate your own API keys for faster and more accurate suggestions.

• 🎯Context-Aware Execution: Remembers command history, tracks files, and adapts suggestions accordingly.

• ⚠️Secure Command Execution: Blocks dangerous commands and asks for confirmation.

• 🛠️Intelligent Debugging & Auto-Correction: Identifies error, autonomously debugs issues and suggests corrected command.

• 🔍Smart Autocompletion: Provides tab completions for files and folder present in working directory.

• 🤖 Direct Execution & Queries: Directly execute shell commands with '!' (e.g., !ls -la), or Ask shell-related questions using '?' (e.g., How do I create a new SSH key?).

• 🐳 Built-in Support for Git, Docker, and Dev Tools: Handles Git, Docker, Kubernetes, and package manager commands effortlessly.

📥 Installation Steps

🚀Get started instantly with just one command:

• Windows:

  pip install promptshell

• Linux & macOS:

  pipx ensurepath # Ensure pipx is in PATH
  pipx install promptshell

🛠 Usage

Basic Commands

• Start the PromptShell REPL
  $ promptshell

• Execute natural language queries
  $ backup all .txt files in a folder named backup

• Directly execute raw shell commands (bypassing AI processing) with '!'
  $ !mkdir backup && copy *.txt backup\

• Ask questions by starting or enging your query with '?'
  $ What’s the command to list all hidden files?

• Configure or change the LLM provider
  $ --config

• View help and usage instructions
  $ --help

• Clear the terminal screen
  $ clear

• Exit PromptShell
  $ quit

👉 Try it, star it, and share your thoughts:
⭐GitHub
🌐Website (Optimized for larger screens)

PS: Your terminal deserves a glow-up. 💅

(Development Preview v0.1.1)

If you have any questions or suggestions, feel free to reach out at

📧Email: kirtirathi282@gmail.com