A plugin for oh-my-zsh that uses a large language model to translate natural-language into Zsh commands.

• Natural-language to commands: Describe what you want in natural-language, and zsh-warrior instantly converts it into an executable Zsh command.
• On-device LLM (Ollama): Uses models run locally by Ollama . All inference happens on-device (offline and private), so your queries are secure and fast.

• Python 3 for communication with ollama
• curl To check the status of Ollama
• Ollama For running the Models

1. Clone the repository: Put zsh-warrior into your Oh My Zsh custom plugins folder:

   git clone https://github.com/OfferPi/zsh-warrior.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-warrior

2. Enable the plugin: Edit your ~/.zshrc and add zsh-warrior to the plugins=(…) list:

   plugins=(
     git
     zsh-warrior
   )

3. Restart or reload Zsh: Close and reopen your terminal, or run source ~/.zshrc, to activate the plugin.

• Type a description: In your Zsh prompt, just start typing what you want the shell to do, in plain English. For example: resize all images in this folder to 800x600.
• Press the hotkey: Hit the shortcut (default Ctrl-o) to trigger zsh-warrior. The plugin will send your query to the local Ollama LLM.
• Get the command: Ollama returns a generated command (e.g. an mogrify or find command) and zsh-warrior inserts it into your prompt.

Inspired by the work of keyvez.