contrib: Add zsh completion scripts #33402

1. 
   mstampfer commented at 10:40 am on September 16, 2025: none

   Adds zsh completion support using the compdef system for:

   • bitcoin-cli with RPC command completion and context-sensitive arguments
   • bitcoin-tx with option/command completion and file path handling
   • bitcoind with configuration option completion

   These complement the existing bash completion scripts and provide the same functionality for zsh users.

2. DrahtBot added the label Scripts and tools on Sep 16, 2025
3. 
   DrahtBot commented at 10:40 am on September 16, 2025: contributor

   ♻️ Automatically closing for now based on heuristics. Please leave a comment, if this was erroneous. Generally, please focus on creating high-quality, original content that demonstrates a clear understanding of the project’s requirements and goals.
4. DrahtBot closed this on Sep 16, 2025

   ---

5. 
   DrahtBot commented at 10:40 am on September 16, 2025: contributor

   The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

   Code Coverage & Benchmarks

   For details see: https://corecheck.dev/bitcoin/bitcoin/pulls/33402.

   Reviews

   See the guideline for information on the review process. A summary of reviews will appear here.

6. 
   mstampfer commented at 10:50 am on September 16, 2025: none

   This PR adds zsh completion scripts for Bitcoin Core tools, converting the existing bash completions to work with zsh’s compdef system. This Improves user experience for zsh users by addressing the need for tab completion support for zsh which doesn’t rely on the existing bash completion scripts.

   The implementation maintains the same functionality as the bash versions while using zsh-native completion functions.

   I’m happy to address any concerns or make requested changes.

7. 
   mstampfer commented at 5:40 pm on September 17, 2025: none

   I have opened an Issue requesting zsh completion support. Please reopen this PR or please comment with any concerns why this feature should not be merged.
8. 
   trevarj commented at 11:30 am on September 24, 2025: none

   @fanquake this seems useful (lots of people on Linux use zsh now and it’s default on MacOS) and I think the bot made a mistake. Could it be reopened?
9. DrahtBot reopened this on Sep 24, 2025

   ---

10. in contrib/completions/zsh/_bitcoind:3 in 3b5e6121f5

    0@@ -0,0 +1,50 @@
    1+#compdef bitcoind bitcoin-qt
    2+# zsh completion for bitcoind(1) and bitcoin-qt(1)
    3+# Copyright (c) 2012-2022 The Bitcoin Core developers
    

    ---

    ---

    

    maflcko commented at 12:19 pm on September 24, 2025:

    nit: for new files, you can drop the year range, or use 2025-present, to avoid having to touch it again in the future.
11. 
    maflcko commented at 12:19 pm on September 24, 2025: member

    You’d have to update the line in the docs? https://github.com/bitcoin/bitcoin/blob/3b5e6121f58f0ca4663deabe793a26be38b0f535/contrib/README.md?plain=1#L45
12. 
    mstampfer commented at 12:58 pm on September 24, 2025: none

    updated 2012-2022 to 2025-present in Copyright statement added zsh completions to README.md
13. 
    maflcko commented at 2:10 pm on September 24, 2025: member

    Please squash your commits according to https://github.com/bitcoin/bitcoin/blob/master/CONTRIBUTING.md#squashing-commits
14. contrib: Add zsh completion scripts for bitcoin tools

    - Add zsh completion scripts for bitcoin-cli, bitcoin-tx, and bitcoind
    - Update README.md to mention zsh completions alongside bash and fish
    - Proper copyright headers and formatting for all zsh completion files

    5f2c0cdf07
15. mstampfer force-pushed on Sep 24, 2025
16. 
    mstampfer commented at 2:49 pm on September 24, 2025: none

    commits squashed to a single commit for this branch

Contributors
mstampfer DrahtBot trevarj maflcko

Labels
Scripts and tools