Argc-completions

{bash,zsh,fish,powershell,nushell}-completions for 1000+ commands.

Features

• Autocomplete for 1000+ commands (full list).
• Automatically generate completion scripts from the help text or man pages.
• Dynamic completion leads to fewer scripts loading and faster terminal startup.
• Easily upgrade completion scripts as command are upgraded.
• Cross shells: bash/zsh/powershell/fish/nushell/elvish/xonsh/tcsh.
• Cross platforms: linux, macOS, and Windows.

Amazing features that native completion lacks or is difficult to implement

<table> <thead> <tr> <th>Feature</th> <th>Showcase</th> </tr> </thead> <tbody> <tr> <td>Parallel Computing</td> <td><img src="https://github.com/sigoden/argc-completions/assets/4012553/9f062328-ad01-470e-963d-ae3f3777ca8c" width="550px" alt="complete-git-checkout"> <pre> _choice_ref() { <br>&nbsp;&nbsp; _argc_util_parallel _choice_branch ::: _choice_tag ::: _choice_head <br>} </pre> </td> </tr> <tr> <td>Fetch remote data</td> <td><img src="https://github.com/sigoden/argc-completions/assets/4012553/cc088b59-ee2f-413b-b2a4-c752c2796625" width="550px" alt="complete-cargo-add"></td> </tr> <tr> <td>Complete multiple values<br>(comma-seperated)</td> <td><img src="https://github.com/sigoden/argc-completions/assets/4012553/ef95ebdc-9c97-4bd1-a485-c928ba614ce9" width="550px" alt="complete-dd-iflag"></td> </tr> <tr> <td>Complete multiple parts</td> <td><img src="https://github.com/sigoden/argc-completions/assets/4012553/e0ca086f-52c1-4cff-be22-a9c0db7bf823" width="550px" alt="complete-rustup-target-add"></td> </tr> <tr> <td>Complete key-value pairs</td> <td><img src="https://github.com/sigoden/argc-completions/assets/4012553/4a31753b-0518-4d7f-8773-cb649ba58e32" width="550px" alt="complete-ssh-o"></td> </tr> <tr> <td>Complete for plugins<br>(git,cargo ...)</td> <td><img src="https://github.com/sigoden/argc-completions/assets/4012553/f9c7a3d6-08fe-48fd-bc23-7b10b6817fb4" width="550px" alt="complete-cargo-nextest"></td> </tr> <tr> <td>Delegate to another command<br>(sudo,doas,npx...)</td> <td><img src="https://github.com/sigoden/argc-completions/assets/4012553/ce198381-997f-4a0c-9126-793b7b8a7324" width="550px" alt="complete-yarn-workspace"></td> </tr> <tr> <td>Style &amp; color</td> <td><img src="https://github.com/sigoden/argc-completions/assets/4012553/77531d0e-5857-4b53-9b0f-52fb48215216" width="550px" alt="complete-colors"></td> </tr> </tbody> </table>

Getting Started

git clone https://github.com/sigoden/argc-completions.git
cd argc-completions
./scripts/download-tools.sh
./scripts/setup-shell.sh bash  # bash/zsh/powershell/fish/nushell/elvish/xonsh/tcsh

For Windows, please run the above code in Git Bash. For macOS, brew install bash gawk gnu-sed to avoid compatibility issues.

Tools downloaded by ./scripts/download-tools.sh:

• argc: completion engine
• yq: YAML/JSON/XML/CSV/TOML processor

Uninstall easily

1. Delete the argc-completions directory that you have downloaded.
2. Undo the changes made to the shell rcfile (~/.bashrc, ~/.zshrc, ...).

Generate your own completion script

./scripts/generate.sh your-command

To learn how generate works, see docs/generate.md

To learn various complete patterns, see docs/complete-patterns.md

License

Argc-completions is made available under the terms of the MIT License.

See the LICENSE file for license details.