Zummoner: ✨ The Zsh Spellbook ✨

Invoke the power of the command line with a whisper!

Tired of remembering complex commands?

🧙‍♂️ Zummoner is a Zsh plugin that summons the right command for you, using the magic of LLMs. Just describe what you want to do, and Zummoner does the rest!

You Use Bash? No Problem! Bummoner.bash works the same as Zummoner.zsh. It's right here in the repo. Clone away!

Features - The Enchantments 🪄

• Command Conjuration: Describe your task in plain English, and Zummoner generates the command. ✨
• System Aware: Knows your system (uname -a) and user for tailored spells. 🤖
• Modern Magic: Prefers modern tools like homectl, ip, systemctl, and journalctl. 🚀
• Customizable LLM: Pick your favorite LLM model, even local. 🧠
• Seamless Integration: Works directly within your Zsh shell. 🐚

Installation - Binding the Spirit 🔗

You can zplug, zinit, zgen it ... it's the right format orrrr manually:

git clone https://github.com/day50-dev/zummoner.git $HOME/.local/zummoner
echo source \$HOME/.local/zummoner/zummoner.zsh >> $HOME/.zshrc
source $HOME/.zshrc

Keybinding: Zummoner uses ^Xx (Ctrl+x, then x) by default. It'll let you know if that key is already taken!

Usage - Uttering the Incantation 🗣️

1. Type what you want to do (e.g., "list all files in the current directory sorted by size").
2. Press ^Xx.
3. Zummoner will show the command!
4. Press Enter to execute. 💥

Incremental Spellcasting

Set the variable before inclusion!

ZUMMONER_SPELL=1

And you will get commented spell casts that you can incrementally modify like below!

Caveats - A Little Magic Caution ⚠️

Zummoner can use either Simon w's llm or DAY50's llcat.

For llcat set the:

• model with LLC_MODEL
• server with LLC_SERVER
• key with LLC_KEY
• mcpfile (if you want) with LLC_MCP

There's also bummoner.sh in here which is the bash version of zummoner.

The future!

This project was a prototype for something much more ambitious of what is now called ono.