Skip to content

Conversation

@vmaerten
Copy link
Member

@vmaerten vmaerten commented Dec 12, 2025

Summary

Add support for the standard Zsh verbose zstyle to customize task completion display.

When users have many tasks, the completion menu can become cluttered with long descriptions. This PR allows users to disable descriptions for a more compact view.

Usage

# Show only task names (no descriptions)
zstyle ':completion:*:*:task:*' verbose false

Why?

The verbose zstyle is the standard Zsh mechanism for controlling description display in completions. It's used by many built-in and third-party completions:

By following this convention, Task integrates naturally with users' existing Zsh configurations.

Behavior

Setting Result
verbose true (default) build Build the project (aliases: b)
verbose false build

@vmaerten vmaerten marked this pull request as ready for review December 12, 2025 21:09
@vmaerten vmaerten self-assigned this Dec 12, 2025
@vmaerten vmaerten added the area: completions Changes related to shell completions and scripts. label Dec 12, 2025
Add zstyle verbose option to customize Zsh completion display:
- `verbose=true` (default): show task descriptions
- `verbose=false`: show only task names

Usage:
  zstyle ':completion:*:*:task:*' verbose false
@vmaerten vmaerten force-pushed the feat/zsh-completion-zstyle-options branch from b70cc92 to 1e1ac65 Compare December 18, 2025 07:34
@vmaerten vmaerten merged commit b710259 into main Dec 18, 2025
13 checks passed
@vmaerten vmaerten deleted the feat/zsh-completion-zstyle-options branch December 18, 2025 07:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: completions Changes related to shell completions and scripts.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant