A simple ZSH plugin that integrates OpenCode AI with your shell, allowing you to generate shell commands using natural language. Press Ctrl+O to transform any text in your command line into optimized shell commands.

• 🤖 AI-powered command generation using OpenCode API
• ⚡ Interactive selection with fzf for choosing between 3 ranked options
• 🎯 Ranked by best practices - speed, safety, and reliability
• 🎨 Smooth UX with animated spinner feedback
• 🔧 Easy configuration for model selection and debug output
• ⌨️ Single keybinding (Ctrl+O) for quick access

• Faster command composition - generate complex shell commands instantly
• Learn shell commands - see how experts would approach tasks
• Interactive choice - pick the best command from 3 ranked options
• No command execution - you control what gets run

This plugin requires:

• opencode - OpenCode CLI for generating commands
• fzf (optional) - For interactive command selection (defaults to first option if not installed)

Visit OpenCode documentation for installation instructions specific to your system.

# macOS with Homebrew
brew install fzf

# Linux with apt
sudo apt-get install fzf

# Or via your package manager
# https://github.com/junegunn/fzf#installation

git clone https://github.com/andreacasarin/zsh-ask-opencode.git $ZSH_CUSTOM/plugins/zsh-ask-opencode

Then add zsh-ask-opencode to the plugins array in your ~/.zshrc:

plugins=(... zsh-ask-opencode)

Reload your shell:

source ~/.zshrc

Add to your ~/.zsh_plugins.txt:

andreacasarin/zsh-ask-opencode

Then run:

antidote bundle

Clone the repository:

git clone https://github.com/andreacasarin/zsh-ask-opencode.git ~/zsh-ask-opencode

Source it in your ~/.zshrc:

source ~/zsh-ask-opencode/zsh-ask-opencode.plugin.zsh

Simply type what you want to do, then press Ctrl+O:

$ list all files modified in the last 24 hours
^O

The plugin will:

1. Show a spinner while asking OpenCode
2. Generate 3 ranked command options
3. Display an fzf menu to select your preferred command
4. Insert the selected command into your command line
5. You can review and press Enter to execute, or edit further

$ compress all jpg files in this directory to 50% size
^O
# Generates: convert *.jpg -quality 50% compressed.jpg

$ find all python files with more than 100 lines
^O
# Generates: find . -name "*.py" -exec wc -l {} + | awk '$1 > 100'

$ restart the docker container named web
^O
# Generates: docker restart web

Change the AI model used for generation by setting ASK_OPENCODE_MODEL:

# In your ~/.zshrc (before sourcing the plugin)
export ASK_OPENCODE_MODEL="github-copilot/gpt-5-mini"  # default
export ASK_OPENCODE_MODEL="github-copilot/gpt-5"      # more powerful

Available models depend on your OpenCode configuration.

Enable debug output to see raw API responses and parsed commands:

# In your ~/.zshrc
export ASK_OPENCODE_DEBUG=1

This will print:

• Raw output from OpenCode (NUL-separated format)
• Parsed command array after splitting
• Helpful for troubleshooting

Example debug output:

[ask_opencode] Raw output (NUL-separated):
     1	command1
     2	command2
     3	command3

[ask_opencode] Parsed commands:
     1	ls -lah
     2	ls -la
     3	ls -l

The default keybinding is Ctrl+O. To change it, add to your ~/.zshrc:

# Change keybinding to Ctrl+G instead
bindkey '^G' ask_opencode

Ensure OpenCode is installed and in your $PATH:

which opencode
# If not found, install it per OpenCode documentation

Check debug output:

ASK_OPENCODE_DEBUG=1 your_prompt_here
^O

Look for error messages from OpenCode in the terminal.

If fzf is not installed, the plugin uses the first generated command by default. Install fzf to enable selection:

brew install fzf  # or your package manager

Verify the file is being sourced:

# For Oh My Zsh
ls -la $ZSH_CUSTOM/plugins/zsh-ask-opencode/

# For manual installation
grep "zsh-ask-opencode" ~/.zshrc

Then reload:

source ~/.zshrc
exec zsh

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

MIT License - see LICENSE for details

Created by Andrea Casarin

• OpenCode - The AI command generation service
• fzf - Interactive fuzzy finder
• Oh My Zsh - ZSH framework
• Antidote - ZSH plugin manager