LLM Zsh Plugin

March 2, 2025 ยท View on GitHub

GitHub stars License: MIT PRs Welcome Zsh 5.0+

Supercharge your shell with LLM command completion ๐Ÿš€

A Zsh plugin providing command completion for the LLM CLI tool by Simon Willison. Supports all LLM commands, model names, and options with intelligent context-aware completion.

๐Ÿš€ Features

  • ๐ŸŽฏ Complete command-line options for all LLM commands
  • ๐Ÿค– Dynamic model name completion
  • ๐Ÿ“ Context-aware subcommand completion
  • ๐Ÿ”ง Supports all major LLM operations:
    • prompt - Execute prompts
    • chat - Interactive chat sessions
    • models - Model management
    • templates - Template handling
    • And much more!

๐Ÿ“ฆ Installation

Using Oh My Zsh

  1. Clone this repository:
git clone https://github.com/eliyastein/llm-zsh-plugin ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/llm
  1. Add llm to your plugins in ~/.zshrc:
plugins=(... llm)
  1. Reload your shell:
source ~/.zshrc

Manual Installation

  1. Clone the repository:
git clone https://github.com/eliyastein/llm-zsh-plugin ~/.zsh/llm-zsh-plugin
  1. Source the plugin in your ~/.zshrc:
source ~/.zsh/llm-zsh-plugin/llm.plugin.zsh
  1. Add the completions directory to your fpath (before compinit):
fpath=(~/.zsh/llm-zsh-plugin/completions $fpath)
  1. Reload your shell:
exec zsh

๐ŸŽฎ Usage

Just start typing an LLM command and press Tab to see available completions:

llm [Tab]              # Show all main commands
llm prompt -[Tab]      # Show prompt options
llm models [Tab]       # Show model subcommands

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork it
  2. Create your feature branch (git checkout -b feature/amazing)
  3. Commit your changes (git commit -am 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing)
  5. Create a new Pull Request

๐Ÿ“ License

MIT License - feel free to use this plugin in your own projects!


Built with โค๏ธ by Eliya Stein