NOTICE: I'm slowly migrating my repositories to my own Git server. Please visit this repository at https://git.myzel394.app/Myzel394/zsh-copilot for the latest updates.

zsh-copilot

Get suggestions truly in your shell. No suggest bullshit. Just press CTRL + Z and get your suggestion.

out.mp4

Installation

Dependencies

Please make sure you have the following dependencies installed:

• zsh-autosuggestions
• jq
• curl

Oh My Zsh

1. Clone zsh-copilot into $ZSH_CUSTOM/plugins (by default ~/.config/oh-my-zsh/custom/plugins)

git clone https://git.myzel394.app/Myzel394/zsh-copilot ${ZSH_CUSTOM:-~/.config/oh-my-zsh/custom}/plugins/zsh-copilot

2. Add zsh-copilot to the plugins array in your .zshrc file:

plugins=( 
    # your other plugins...
    zsh-autosuggestions
)

Manual Installation

git clone https://git.myzel394.app/Myzel394/zsh-copilot ~/.config/zsh-copilot
echo "source ~/.config/zsh-copilot/zsh-copilot.plugin.zsh" >> ~/.zshrc

Configuration

You need to have an API key for either OpenAI or Anthropic to use this plugin. Expose this via the appropriate environment variable:

For OpenAI (default):

export OPENAI_API_KEY=<your-openai-api-key>

For Anthropic:

export ANTHROPIC_API_KEY=<your-anthropic-api-key>

You can configure the AI provider using the ZSH_COPILOT_AI_PROVIDER variable:

export ZSH_COPILOT_AI_PROVIDER="openai"  # or "anthropic"

Other configuration options:

• ZSH_COPILOT_KEY: Key to press to get suggestions (default: ^z)
• ZSH_COPILOT_SEND_CONTEXT: If true, zsh-copilot will send context information to the AI model (default: true)
• ZSH_COPILOT_DEBUG: Enable debug logging (default: false)

To see all available configurations and their current values, run:

zsh-copilot

Usage

Type in your command or your message and press CTRL + Z to get your suggestion!