Skip to content

wakefun/omz-claude

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

omz-claude

An oh-my-zsh plugin providing tab completion for the Claude Code CLI.

Features

  • Full tab completion for all claude CLI options and commands
  • Dynamic completion for --settings with ~/.claude/settings.*.json files
  • Shortcut mode: type config name directly to expand to full --settings path
  • Cross-platform support (macOS, Linux)

Requirements

Installation

One-line Install

curl -fsSL https://raw.githubusercontent.com/wakefun/omz-claude/main/install.sh | bash && source ~/.zshrc

The installer will try to add claude to your plugins=(...) line in ~/.zshrc and create a backup at ~/.zshrc.omz-claude.bak.
If your plugins are managed differently, add claude manually.

Manual Install

git clone https://github.com/wakefun/omz-claude.git
cp -r omz-claude/claude ~/.oh-my-zsh/custom/plugins/

Usage

Option Completion

claude --<TAB>          # List all available options
claude --output-<TAB>   # Complete to --output-format

Command Completion

claude <TAB>            # List all commands (mcp, plugin, doctor, etc.)
claude m<TAB>           # Complete to 'mcp'
claude up<TAB>          # Complete to 'update'

Settings File Completion

claude --settings <TAB>   # List all settings files
claude --settings k<TAB>  # Complete to ~/.claude/settings.kimi.json

Shortcut Mode (Recommended)

Type the config name directly without --settings to quickly switch between Claude configurations:

claude k<TAB>    # Expands to: claude --settings ~/.claude/settings.kimi.json
claude oa<TAB>   # Expands to: claude --settings ~/.claude/settings.oaipro.json

Shortcut and command completion are prefix-based (e.g., typing k<TAB> only matches configs/commands starting with k).

Settings File Convention

The plugin automatically scans ~/.claude/ for settings files matching this pattern:

Path: ~/.claude/settings.<config-name>.json

Examples:

Filename Config Name Shortcut
settings.kimi.json kimi claude k<TAB>
settings.oaipro.json oaipro claude oa<TAB>
settings.deepseek.json deepseek claude d<TAB>

New configurations are detected automatically without restarting the terminal.

File Structure

claude/
├── _claude            # Completion script
└── claude.plugin.zsh  # Plugin entry point

Supported Commands

Command Description
mcp Configure and manage MCP servers
plugin Manage Claude Code plugins
setup-token Set up authentication token
doctor Check auto-updater health
update Check for updates
install Install Claude Code native build

License

MIT

About

An oh-my-zsh plugin providing tab completion for the Claude Code CLI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages