Zsh Claude Code Shell

zsh-claude-code-shell

An oh-my-zsh plugin that translates natural language comments into shell commands using [Claude Code](https://claude.ai/claude-code).

Demo

# find all js files larger than 100kb modified in the last week and show their sizes

Press Enter, and the line becomes:

find . -name "*.js" -size +100k -mtime -7 -exec ls -lh {} \;

Review the command, press Enter again to execute.

Another example:

# recursively find and delete all node_modules folders

Becomes:

find . -type d -name "node_modules" -prune -exec rm -rf {} +

Prerequisites

• Claude Code CLI installed and authenticated
• zsh shell
• oh-my-zsh (optional, for easiest installation)

Installation

oh-my-zsh

Clone to your custom plugins directory:

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

Add to your `~/.zshrc`:

plugins=(... zsh-claude-code-shell)

Restart your shell or run `source ~/.zshrc`.

Manual

Clone the repository and source the plugin:

git clone https://github.com/ArielTM/zsh-claude-code-shell ~/zsh-claude-code-shell
echo 'source ~/zsh-claude-code-shell/zsh-claude-code-shell.plugin.zsh' >> ~/.zshrc

zinit

zinit light ArielTM/zsh-claude-code-shell

zplug

zplug "ArielTM/zsh-claude-code-shell"

Usage

1. Type a comment starting with # followed by what you want to do
2. Press Enter
3. The comment is replaced with the generated command
4. Review the command, press Enter to execute (or edit it first)

Examples

# find all TODO comments in typescript files
# becomes: grep -rn "TODO" --include="*.ts" .

# show top 10 largest files in current directory recursively
# becomes: find . -type f -exec du -h {} + | sort -rh | head -10

# kill all processes matching "node"
# becomes: pkill -f node

# compress all l