Cc Completion

Claude Code Shell Completion

🇯🇵 [日本語版はこちら](README.ja.md)

Shell completion scripts for [Claude Code](https://claude.com/claude-code), providing tab completion for commands, subcommands, and options in bash, zsh, and [Nushell](https://www.nushell.sh/).

Features

• Command completion: Tab complete claude subcommands (agents, auto-mode, auth, mcp, plugin, plugins, setup-token, doctor, gateway, import, update, upgrade, install, ultrareview)
• Option completion: All CLI options and flags are completable
• Contextual suggestions: Option values are suggested where applicable
  • Output formats: text, json, stream-json
  • Permission modes: acceptEdits, bypassPermissions, manual, dontAsk, plan, auto
  • Models: sonnet, opus, haiku, etc.
  • Setting sources: user, project, local
  • Effort levels: low, medium, high, xhigh, max
  • Tool names: Bash, Read, Edit, Agent, Skill, etc. plus default (for --tools, --allowedTools, --disallowedTools)
• File path completion: For options that expect file paths (e.g., --settings, --mcp-config, --add-dir, --file, --debug-file)
• Subcommand completion: Full subcommand trees for mcp and plugin commands

Quick Start

git clone https://github.com/hmmf022/cc-completion.git
cd cc-completion

Bash

mkdir -p ~/.local/share/bash-completion/completions
ln -sf "$(pwd)/claude-completion.bash" ~/.local/share/bash-completion/completions/claude
source ~/.local/share/bash-completion/completions/claude

Zsh

sudo ln -sf "$(pwd)/_claude" /usr/local/share/zsh/site-functions/_claude
autoload -Uz compinit && compinit

Nushell

Add to your Nushell config file (`$nu.config-path`):

use /path/to/cc-completion/claude-completions.nu *

For other installation methods (oh-my-zsh, system-wide bash, etc.), see [Installation Details](#installation-details) below.