Zsh Claude Enhancer

zsh-claude-enhancer

A zsh plugin that transforms natural language into shell commands using Claude Code.


Prerequisites

• zsh
• claude-code

Installation

antidote

Add this to your `.zsh_plugins.txt`:

vnva/zsh-claude-enhancer

Then reload antidote:

antidote load

oh-my-zsh

Clone this repository into your Oh My Zsh custom plugins directory:

git clone https://github.com/vnva/zsh-claude-enhancer ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-claude-enhancer

Add the plugin to your `.zshrc`:

plugins=(... zsh-claude-enhancer)

Restart your shell:

source ~/.zshrc

prezto

Clone this repository into your Prezto modules directory:

git clone https://github.com/vnva/zsh-claude-enhancer ${ZDOTDIR:-$HOME}/.zprezto/modules/zsh-claude-enhancer

Add the module to your `.zpreztorc`:

zstyle ':prezto:load' pmodule \
  ... \
  zsh-claude-enhancer

Manual Installation

Clone this repository:

git clone https://github.com/yourusername/zsh-claude-enhancer ~/.zsh-claude-enhancer

Add this to your `.zshrc`:

source ~/.zsh-claude-enhancer/zsh-claude-enhancer.plugin.zsh

Restart your shell:

source ~/.zshrc

Configuration

Configure the plugin by setting environment variables in your `.zshrc`:

# Optional: Choose Claude model (default: "sonnet")
export ZSH_CLAUDE_ENHANCER_MODEL="sonnet"  # or "opus"

# Optional: Custom keybinding (default: Alt+\)
export ZSH_CLAUDE_ENHANCER_KEYBINDING="^[\\"

Model Options

• sonnet - default, faster
• opus - more powerful

Keybinding

The default keybinding is `Alt+\`. Common keybinding formats:

• ^[\ - Alt+\ (default)
• ^[a - Alt+a
• `^x