I'm currently seeing the same behaviour. I also tried source from my .zshrc file directly, and while this does work it produces this error every time I open a new shell:

_arguments:comparguments:325: can only be called from completion function

I believe adding the completions file inside $fpath is the correct way, but as mentioned here this results in autocomplete not working unless a command has been ran at least once.

I have the same issue as @citypaul. I've dumped the Zellij zsh completion into a separate file and sourced it in my .zshrc.

I also have the same issue. I was able to find a workaround that got me the functionality I was looking for originally, it does not address the bug here but it will get rid of the warning if you are just looking to use the functions.

I just deleted everything in the completions and left the functions.

#compdef zellij

function zr () { zellij run --name "$*" -- zsh -ic "$*";}
function zrf () { zellij run --name "$*" --floating -- zsh -ic "$*";}
function ze () { zellij edit "$*";}
function zef () { zellij edit --floating "$*";}

This is also an issue in fish.

The fish shell has user completions in …/completions/ and user defined functions/aliases in …/functions/, where … is the fish configuration directory.

If completions are saved as zellij.fish and the functions in separate files (zr.fish and so on), everything will be loaded automatically.

In the current (v0.35.2) setup functions aren't loaded until after first attempt of completion.

See also: #2186

Edit: Added reference to issue 2186.

I did the same as @dubst3pp4 and for some reason i get _arguments:comparguments:327: can only be called from completion function

Same issue here.
I have this workaround in my zshrc

if [[ -x "$(command -v zellij)" ]];
then
    eval "$(zellij setup --generate-completion zsh | grep "^function")"
fi;

same issue occurs in 0.38.2 version, I think it make no sense that put alias function in the completion file, they should be seperated into different files

Same issue here. I have this workaround in my zshrc

if [[ -x "$(command -v zellij)" ]];
then
    eval "$(zellij setup --generate-completion zsh | grep "^function")"
fi;

😂 a bit strange solution, but it really works

I found this with bash on a Fedora 39 server.

My hack fix was to move the functions into ~/.bashrc.d/zellij.bash

Just ran into this, macos + zsh here

I also ran into this...if so many people are experiencing this, since 2022, shouldn't the docs be editted? Is there some reason no PR is being opened?

I also ran into this...if so many people are experiencing this, since 2022, shouldn't the docs be editted? Is there some reason no PR is being opened?

IIRC, we talked about updating docs for this in Discord but since these have to be maintained (keep up-to-date, etc) it was decided to leave them they are until a fix for this is found.

I explored this but couldn't find a fix that didn't require splitting completion functions from normal ones:
#1860 (reply in thread)

I finally got zellij zsh completion to work using the zsh definition using the following workarounds:

# 1 Using zsh's native compinit:

Apparently the 2022 update of ZSH (currently the latest) had some changes to discourage loading of completion code manully, and favours auto loading when it's needed. However some users (and app maintainers) have founds how to workaround it.
The solution is to manually call compdef _<command_name> <command_name> after the definition to load it manually.

The sed below takes care of that.

autoload -U +X compinit && compinit
. <( zellij setup --generate-completion zsh | sed -Ee 's/^(_(zellij) ).*/compdef \1\2/' )

# 2 Using bashcompinit bash-completion wrapper:

autoload -U +X compinit bashcompinit && compinit && bashcompinit
. <( zellij setup --generate-completion bash )

I personally prefer # 1, but in case that stops to work # 2 can be a fallback until things are fixed again.

@imsnif could you update the --generate-completion zsh to replace the _zellij call with compdef _zellij zellij ?

I finally got zellij zsh completion to work using the zsh definition using the following workarounds:

# 1 Using zsh's native compinit:

Apparently the 2022 update of ZSH (currently the latest) had some changes to discourage loading of completion code manully, and favours auto loading when it's needed. However some users (and app maintainers) have founds how to workaround it. The solution is to manually call compdef _<command_name> <command_name> after the definition to load it manually.

The sed below takes care of that.

@Lockszmith-GH, thank you for this! I know this may not be the most appropriate place, but I figured I'd leave a comment here in case anybody else like me ends up on this thread too - I've gotten it working with the same method and I've also extended it so that it will tab complete session names for delete-session/d, attach/a, and kill-session/k. A patch for the completions can be found here, if you're like me and you save them to a file. If you want to use a sed command like in the comment above, you can use either of the following:

. <( zellij setup --generate-completion zsh | sed -Ee '/^autoload -U is-at-least/a\
\
_zellij_sessions() {\
    local line sessions desc; sessions=("${(@f)$(zellij ls -n)}")\
    local -a session_names_with_desc\
    for line in "${sessions[@]}"; do\
        session_name=${line%% *}\
        desc=${line#* }\
        session_names_with_desc+=("$session_name:$desc")\
    done\
    _describe -t sessions '\''active session'\'' session_names_with_desc\
}\' -e 's/^(\(attach)/\1|a/' -e 's/::session-name -- Name of the session to attach to:/::session-name:_zellij_sessions/' -e 's/^(\(kill-session)/\1|k/' -e 's/::target-session -- Name of target session:/::target-session:_zellij_sessions/' -e 's/^(\(delete-session)/\1|d/' -e 's/^(_(zellij) ).*/compdef \1\2/')