[Bug]: Waveterm dosen't work out of the box if you use antidote.sh

[rantos9]

Current Behavior

I'm not sure if this should be considered a bug or not. I'm writing this here more so other people can find the solution more easily.

Waveterm has it's own directory for zsh config files and sets it's own $ZDOTDIR.
This clashes with antidotes's defaults and creates a semi-broken shell where none of your plugins are loaded. This is the error I was getting:

antidote: bundle file not found '/Users/renan/Library/Application Support/waveterm/shell/zsh/.zsh_plugins.txt'.

For a quick fix one can just run antidote load since $ZDOTDIR is unset by the time the user gets access to the terminal and it then loads plugins from the home directory instead of trying loading from $ZDOTDIR . I'm not sure if things below antidote load on the user's .zshrc are set tho, I believe they are not.

For a more permanent fix one can set these lines on Waveterm's .zshrc to remove$ZDOTDIR from antidote load default just when you're using Waveterm.

zstyle ':antidote:bundle' file ${HOME}/.zsh_plugins.txt
zstyle ':antidote:static' file ${HOME}/.zsh_plugins.zsh

These have to be placed before the original .zshrc is sourced.

Waveterm's .zshrc is located at $HOME/Library/Application\ Support/waveterm/shell/zsh/.zshrc

Expected Behavior

I expected the terminal to work out of the box with all my plugins. Or at least a nice warning telling the user how to fix it and where Waveterm's zsh dot files resides.

Steps To Reproduce

1. Install antidote.sh
2. Install some plugins
3. Install Waveterm

Wave Version

Client Version 0.11.2 (202503082049)

Platform

macOS

OS Version/Distribution

macOS Sequoia 15.3.2

Architecture

arm64

Anything else?

No response

Questionnaire

• I'm interested in fixing this myself but don't know where to start
• I would like to fix and I have a solution
• I don't have time to fix this right now, but maybe later

[DTS-And-Eaglepoint-Funding]

same here but im on linux
i got it to work by sim-linking .zsh_plugins.zsh and .zsh_plugins.txt to waveterm/shell/zsh/