Claude Code Zsh Completion — Development skill for Claude Code

[](https://github.com/1160054/claude-code-zsh-completion/actions/workflows/test.yml) [](https://github.com/1160054/claude-code-zsh-completion/releases) [](https://opensource.org/licenses/MIT) [](https://github.com/1160054/claude-code-zsh-completion/tree/main/completions)

claude-code-zsh-completion

Zsh completion for the Claude Code CLI. It reads your own configuration, so `claude --resume ` lists the sessions you can actually resume — each one labelled with what you asked in it — instead of leaving you to remember a UUID.


Features

• Sessions, background sessions, MCP servers, agents, models and plugins completed from your own configuration, not from a fixed list
• Completion for every claude command, subcommand and option
• Descriptions alongside each candidate, so you can pick without leaving the prompt
• Values completed for options that have a fixed set (--permission-mode, --output-format, …)
• Localized into 120+ languages

Requirements

• Zsh 5.0 or later
• Claude Code CLI installed

Installation

[Homebrew](https://brew.sh/)

brew tap 1160054/claude https://github.com/1160054/claude-code-zsh-completion
brew trust 1160054/claude
brew install claude-code-zsh-completion

Homebrew 6 refuses to load formulae from a third-party tap until you trust it, hence the middle step.

No `~/.zshrc` changes are needed — Homebrew's `site-functions` directory is already on your `fpath`. `brew upgrade` keeps the completion current.

Every localized completion is installed alongside the English one. To switch:

ln -sf "$(brew --prefix)/share/claude-code-zsh-completion/completions/_c