{"id":49494044,"url":"https://github.com/hmmf022/cc-completion","last_synced_at":"2026-05-01T08:32:34.015Z","repository":{"id":328284892,"uuid":"1114932024","full_name":"hmmf022/cc-completion","owner":"hmmf022","description":"Shell completion scripts for Claude Code CLI - tab completion for commands, options, and arguments   in bash, zsh and nushell","archived":false,"fork":false,"pushed_at":"2026-04-20T00:28:55.000Z","size":142,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-20T02:37:37.512Z","etag":null,"topics":["autocomplete","bash","claude-code","completion","nushell","shell","zsh"],"latest_commit_sha":null,"homepage":"","language":"Nushell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hmmf022.png","metadata":{"files":{"readme":"README.ja.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-12T05:13:28.000Z","updated_at":"2026-04-20T00:28:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hmmf022/cc-completion","commit_stats":null,"previous_names":["hmmf022/cc-completion"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hmmf022/cc-completion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmmf022%2Fcc-completion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmmf022%2Fcc-completion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmmf022%2Fcc-completion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmmf022%2Fcc-completion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hmmf022","download_url":"https://codeload.github.com/hmmf022/cc-completion/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hmmf022%2Fcc-completion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32490810,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autocomplete","bash","claude-code","completion","nushell","shell","zsh"],"created_at":"2026-05-01T08:32:28.698Z","updated_at":"2026-05-01T08:32:33.993Z","avatar_url":"https://github.com/hmmf022.png","language":"Nushell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Code Shell Completion\n\n🇺🇸 [English version](README.md)\n\n[Claude Code](https://claude.com/claude-code) 用のシェル補完スクリプトです。bash、zsh、[Nushell](https://www.nushell.sh/) で、コマンド、サブコマンド、オプションのタブ補完を提供します。\n\n## 機能\n\n- **コマンド補完**: `claude` のサブコマンドをタブ補完 (`agents`, `auto-mode`, `auth`, `mcp`, `plugin`, `plugins`, `setup-token`, `doctor`, `update`, `upgrade`, `install`, `ultrareview`)\n- **オプション補完**: すべての CLI オプションとフラグを補完可能\n- **コンテキストに応じた候補表示**: 該当する場合、オプションの値を候補として表示\n  - 出力フォーマット: `text`, `json`, `stream-json`\n  - パーミッションモード: `acceptEdits`, `bypassPermissions`, `default`, `dontAsk`, `plan`, `auto`\n  - モデル: `sonnet`, `opus`, `haiku` など\n  - 設定ソース: `user`, `project`, `local`\n  - エフォートレベル: `low`, `medium`, `high`, `xhigh`, `max`\n- **ファイルパス補完**: ファイルパスを受け取るオプション (`--settings`, `--mcp-config`, `--add-dir`, `--file`, `--debug-file` など)\n- **サブコマンド補完**: `mcp` と `plugin` コマンドの完全なサブコマンドツリー\n\n## クイックスタート\n\n```bash\ngit clone https://github.com/hmmf022/cc-completion.git\ncd cc-completion\n```\n\n### Bash\n\n```bash\nmkdir -p ~/.local/share/bash-completion/completions\nln -sf \"$(pwd)/claude-completion.bash\" ~/.local/share/bash-completion/completions/claude\nsource ~/.local/share/bash-completion/completions/claude\n```\n\n### Zsh\n\n```bash\nsudo ln -sf \"$(pwd)/_claude\" /usr/local/share/zsh/site-functions/_claude\nautoload -Uz compinit \u0026\u0026 compinit\n```\n\n### Nushell\n\nNushell の設定ファイル (`$nu.config-path`) に以下を追加してください:\n```nu\nuse /path/to/cc-completion/claude-completions.nu *\n```\n\n\u003e 他のインストール方法 (oh-my-zsh、システム全体への bash インストールなど) は、下記の[インストール詳細](#インストール詳細)を参照してください。\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ch2\u003eインストール詳細\u003c/h2\u003e\u003c/summary\u003e\n\n### Bash\n\n#### 方法 1: システム全体へのインストール\n\n**オプション A: コピー (シンプル)**\n```bash\nsudo cp claude-completion.bash /etc/bash_completion.d/claude\n```\n\u003e 注意: リポジトリを更新した場合 (`git pull` など)、再度ファイルをコピーする必要があります。\n\n**オプション B: シンボリックリンク (推奨)**\n```bash\nsudo ln -sf \"$(pwd)/claude-completion.bash\" /etc/bash_completion.d/claude\n```\n\u003e 注意: `git pull` で自動的に更新が反映されます。クローンしたリポジトリを削除・移動しないでください。\n\nその後、シェルを再起動するか以下を実行してください:\n```bash\nsource /etc/bash_completion.d/claude\n```\n\n#### 方法 2: ユーザーレベルのインストール\n\n```bash\nmkdir -p ~/.local/share/bash-completion/completions\n```\n\n**オプション A: コピー (シンプル)**\n```bash\ncp claude-completion.bash ~/.local/share/bash-completion/completions/claude\n```\n\u003e 注意: リポジトリを更新した場合 (`git pull` など)、再度ファイルをコピーする必要があります。\n\n**オプション B: シンボリックリンク (推奨)**\n```bash\nln -sf \"$(pwd)/claude-completion.bash\" ~/.local/share/bash-completion/completions/claude\n```\n\u003e 注意: `git pull` で自動的に更新が反映されます。クローンしたリポジトリを削除・移動しないでください。\n\n`~/.bashrc` に以下を追加してください:\n```bash\nsource ~/.local/share/bash-completion/completions/claude\n```\n\n#### 方法 3: 手動で source する\n\n`~/.bashrc` に以下を追加してください:\n```bash\nsource /path/to/claude-completion.bash\n```\n\n### Zsh\n\n#### 方法 1: システム全体へのインストール\n\n**オプション A: コピー (シンプル)**\n```bash\nsudo cp _claude /usr/local/share/zsh/site-functions/_claude\n```\n\u003e 注意: リポジトリを更新した場合 (`git pull` など)、再度ファイルをコピーする必要があります。\n\n**オプション B: シンボリックリンク (推奨)**\n```bash\nsudo ln -sf \"$(pwd)/_claude\" /usr/local/share/zsh/site-functions/_claude\n```\n\u003e 注意: `git pull` で自動的に更新が反映されます。クローンしたリポジトリを削除・移動しないでください。\n\nその後、補完を再読み込みしてください:\n```zsh\nrm -f ~/.zcompdump; compinit\n```\n\n#### 方法 2: oh-my-zsh を使ったユーザーレベルのインストール\n\n```bash\nmkdir -p ~/.oh-my-zsh/custom/plugins/claude\n```\n\n**オプション A: コピー (シンプル)**\n```bash\ncp _claude ~/.oh-my-zsh/custom/plugins/claude/_claude\n```\n\u003e 注意: リポジトリを更新した場合 (`git pull` など)、再度ファイルをコピーする必要があります。\n\n**オプション B: シンボリックリンク (推奨)**\n```bash\nln -sf \"$(pwd)/_claude\" ~/.oh-my-zsh/custom/plugins/claude/_claude\n```\n\u003e 注意: `git pull` で自動的に更新が反映されます。クローンしたリポジトリを削除・移動しないでください。\n\n`~/.zshrc` に以下を追加してください:\n```zsh\nplugins=(... claude)\n```\n\n#### 方法 3: 手動で fpath を設定\n\n`~/.zshrc` の `compinit` より前に以下を追加してください:\n```zsh\nfpath=(/path/to/cc-completion $fpath)\nautoload -Uz compinit \u0026\u0026 compinit\n```\n\n### Nushell\n\nNushell の設定ファイル (`$nu.config-path`) に以下を追加してください:\n```nu\nuse /path/to/cc-completion/claude-completions.nu *\n```\n\u003e 注意: `/path/to/cc-completion` をクローンしたリポジトリの実際のパスに置き換えてください。\n\n\u003c/details\u003e\n\n## 使用例\n\nインストール後、`claude` コマンドでタブ補完が使えるようになります:\n\n```bash\n# サブコマンドの補完\nclaude \u003cTAB\u003e\n# 表示: agents auto-mode auth mcp plugin plugins setup-token doctor update upgrade install ultrareview\n\n# オプションの補完\nclaude --\u003cTAB\u003e\n# 表示: --debug --verbose --print --model --help ...\n\n# オプション値の補完\nclaude --output-format \u003cTAB\u003e\n# 表示: text json stream-json\n\nclaude --permission-mode \u003cTAB\u003e\n# 表示: acceptEdits bypassPermissions default dontAsk plan auto\n\nclaude --model \u003cTAB\u003e\n# 表示: sonnet opus haiku best sonnet1m\n\nclaude --effort \u003cTAB\u003e\n# 表示: low medium high xhigh max\n\n# install のターゲット補完\nclaude install \u003cTAB\u003e\n# 表示: stable latest --force --help\n\n# auth サブコマンドの補完\nclaude auth \u003cTAB\u003e\n# 表示: login logout status\n\n# auth login オプションの補完\nclaude auth login --\u003cTAB\u003e\n# 表示: --claudeai --console --email --sso --help\n\n# auth status オプションの補完\nclaude auth status --\u003cTAB\u003e\n# 表示: --json --text --help\n\n# mcp サブコマンドの補完\nclaude mcp \u003cTAB\u003e\n# 表示: add add-from-claude-desktop add-json get list remove reset-project-choices serve\n\n# mcp add オプションの補完\nclaude mcp add --transport \u003cTAB\u003e\n# 表示: stdio sse http\n\n# plugin サブコマンドの補完\nclaude plugin \u003cTAB\u003e\n# 表示: disable enable install list marketplace prune autoremove tag uninstall update validate\n\n# ファイルパスの補完\nclaude --settings \u003cTAB\u003e\n# ファイルとディレクトリを表示\n```\n\n## 対応コマンド\n\n- `agents` - 設定済みのエージェントを一覧表示 (`--setting-sources` オプション付き)\n- `auto-mode` - 自動モード分類器の設定を確認\n  - `config` - 自動モード分類器の設定を表示\n  - `critique` - 会話に対して自動モードの批評を実行 (`--model` オプション付き)\n  - `defaults` - 自動モード分類器のデフォルト設定を表示\n- `auth` - 認証の管理\n  - `login` - Anthropic アカウントにサインイン (`--claudeai`, `--console`, `--email`, `--sso` オプション付き)\n  - `logout` - Anthropic アカウントからログアウト\n  - `status` - 現在の認証状態を表示 (`--json`, `--text` オプション付き)\n- `mcp` - MCP サーバーの設定・管理\n  - `add` - MCP サーバーを追加 (`--scope`, `--transport`, `--env`, `--header`, `--callback-port`, `--client-id`, `--client-secret` オプション付き)\n  - `add-from-claude-desktop` - Claude Desktop から MCP サーバーをインポート (`--scope` オプション付き)\n  - `add-json` - JSON 文字列で MCP サーバーを追加\n  - `get` - MCP サーバーの詳細を取得\n  - `list` - 設定済みの MCP サーバーを一覧表示\n  - `remove` - MCP サーバーを削除 (`--scope` オプション付き)\n  - `reset-project-choices` - プロジェクトスコープのサーバーの承認・拒否をすべてリセット\n  - `serve` - Claude Code MCP サーバーを起動\n- `plugin` - Claude Code プラグインの管理\n  - `disable` - 有効なプラグインを無効化\n  - `enable` - 無効なプラグインを有効化\n  - `install` (`i`) - 利用可能なマーケットプレイスからプラグインをインストール\n  - `list` - インストール済みのプラグインを一覧表示\n  - `marketplace` - Claude Code マーケットプレイスの管理 (`add`, `list`, `remove` (`rm`), `update`)\n  - `prune` (`autoremove`) - 不要になった自動インストール依存を削除 (`--dry-run`, `--scope`, `--yes` オプション付き)\n  - `tag` - プラグインリリース用に `{name}--v{version}` の git タグを作成 (`--dry-run`, `--force`, `--message`, `--push`, `--remote` オプション付き)\n  - `uninstall` (`remove`) - インストール済みのプラグインをアンインストール (`--keep-data`, `--prune`, `--scope`, `--yes` オプション付き)\n  - `update` - プラグインを最新バージョンに更新\n  - `validate` - プラグインまたはマーケットプレイスのマニフェストを検証\n- `setup-token` - 長期認証トークンを設定\n- `doctor` - Claude Code 自動アップデーターの健全性をチェック\n- `update` - アップデートを確認し、利用可能な場合はインストール\n- `plugins` - `plugin` のエイリアス\n- `upgrade` - `update` のエイリアス\n- `install` - Claude Code ネイティブビルドをインストール (`--force` オプション付き)\n- `ultrareview` - 現在のブランチ (または PR 番号 / ベースブランチ) に対するクラウドホスト型のマルチエージェントコードレビューを実行 (`--json`, `--timeout` オプション付き)\n\n## 対応オプション\n\nすべての Claude Code CLI オプションに対応しています:\n\n- セッション管理: `--continue`, `--resume`, `--fork-session`, `--from-pr`\n- モデル選択: `--model`, `--fallback-model`\n- 出力制御: `--print`, `--output-format`, `--input-format`\n- パーミッション: `--permission-mode`, `--dangerously-skip-permissions`\n- ツール: `--tools`, `--allowed-tools`, `--disallowed-tools`\n- MCP: `--mcp-config`, `--strict-mcp-config`\n- ファイルリソース: `--file`\n- ワークツリー: `--worktree`, `--tmux`\n- デバッグ: `--debug`, `--debug-file`\n- その他多数...\n\n## テスト\n\nインストールを確認するには:\n\n```bash\n# bash の場合\ntype _claude_completion\n\n# zsh の場合\nwhich _claude\n```\n\nNushell の場合、補完が読み込まれていることを確認してください:\n```nu\n# 外部コマンドが登録されているか確認\nhelp commands | where name =~ \"claude\"\n```\n\nタブ補完を試してみてください:\n```bash\nclaude --mod\u003cTAB\u003e\n# 以下のように補完されるはずです: claude --model\n```\n\n## トラブルシューティング\n\n### Bash の補完が動作しない場合\n\n1. `bash-completion` パッケージがインストールされていることを確認してください:\n   ```bash\n   # Ubuntu/Debian\n   sudo apt-get install bash-completion\n\n   # macOS (Homebrew)\n   brew install bash-completion@2\n   ```\n\n2. bash-completion がシェルに読み込まれていることを確認してください:\n   ```bash\n   type _init_completion\n   ```\n\n### Zsh の補完が動作しない場合\n\n1. `~/.zshrc` で `compinit` が呼び出されていることを確認してください:\n   ```zsh\n   autoload -Uz compinit \u0026\u0026 compinit\n   ```\n\n2. 補完キャッシュを再構築してください:\n   ```zsh\n   rm -f ~/.zcompdump*; compinit\n   ```\n\n3. 補完関数が読み込まれていることを確認してください:\n   ```zsh\n   which _claude\n   ```\n\n### Nushell の補完が動作しない場合\n\n1. Nushell 0.80 以降を使用していることを確認してください (`extern` 補完に必要):\n   ```nu\n   version\n   ```\n\n2. 補完が登録されていることを確認してください:\n   ```nu\n   help commands | where name =~ \"claude\"\n   ```\n\n## コントリビュート\n\n不足しているコマンドやオプションを見つけた場合は、補完スクリプトを更新してください:\n\n- bash の場合: `claude-completion.bash` を編集\n- zsh の場合: `_claude` を編集\n- Nushell の場合: `claude-completions.nu` を編集\n\n## ライセンス\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmmf022%2Fcc-completion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhmmf022%2Fcc-completion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhmmf022%2Fcc-completion/lists"}