Bug: (eval):1: unknown file attribute: h

[peterldowns]

I recently updated mise to the latest version with mise self-update

• mise version
              _                                        __
   ____ ___  (_)_______        ___  ____        ____  / /___ _________
  / __ `__ \/ / ___/ _ \______/ _ \/ __ \______/ __ \/ / __ `/ ___/ _ \
 / / / / / / (__  )  __/_____/  __/ / / /_____/ /_/ / / /_/ / /__/  __/
/_/ /_/ /_/_/____/\___/      \___/_/ /_/     / .___/_/\__,_/\___/\___/
                                            /_/                 by @jdx
2026.7.17 macos-arm64 (2026-07-30)

This had the effect of breaking all of my tab completion, I started seeing these errors:

• mise run //[WARN  usage::spec] This usage spec requires at least version 4.0, but you are using version 3.5.6 of usage
  × Invalid usage config
    ╭─[/var/folders/wb/1hxcm9js0zd0sfgkj4r3959c0000gn/T//usage__usage_spec_mise_2025_11_4.spec:96:67]
 95 │ arg "[-- TASK_ARGS_LAST]…" required=#false var=#true hide=#true
 96 │ cmd activate help="Initializes mise in the current shell session" effect=read {
    ·                                                                   ─────┬─────
    ·                                                                        ╰── unsupported cmd prop effect
 97 │     long_help #"""

So I updated to usage @ v4.0.0

• mise use -g usage@v4.0.0
[...]
• usage --version
usage-cli 4.0.0
• which usage
/Users/pd/.local/share/mise/installs/usage/v4.0.0/usage

But now when I tab-complete, I get a different error. If I type mise run <tab>, I see:

• mise run mise run
(eval):1: unknown file attribute: h

The duplicate mise run mise run is what the <tab> completes to.

[peterldowns]

Update: I resolved this. The issue was a stale generated zsh completion file, not the mise/usage binaries alone.

Even after upgrading to mise 2026.7.17 and usage 4.0.0, zsh was still loading:

~/.local/share/zsh/site-functions/_mise

That file had been generated for mise 2025.11.4 and used the old completion protocol:

_arguments "*: :(($(command usage complete-word --shell zsh -f \"$spec_file\" -- \"${words[@]}\" )))"

Current usage complete-word returns tab-separated values, descriptions, and insertions. The old wrapper passed that output into an expression evaluated by zsh. One of my mise task descriptions contained:

(host-run, no Docker builds)

Zsh interpreted (host-run, ...) as glob qualifiers, which explains:

(eval):1: unknown file attribute: h

It also explains the duplicated mise run mise run completion.

Regenerating the completion file fixed it:

mise self-update
mise use --global --pin usage@4.0.0 --minimum-release-age 0d
mise completion zsh > ~/.local/share/zsh/site-functions/_mise
exec zsh

The newly generated _mise completion parses the tab-separated fields and passes them safely to compadd. mise run <TAB> now lists the tasks correctly with no warnings or eval errors.

So the initial version warning was legitimate, but upgrading/downgrading alone could not fix the second error because the independently generated _mise file remained stale. It may be worth documenting that the shell completion file needs to be regenerated after an incompatible mise/usage completion-protocol update.