Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

zsh tab completion not working

Open
  • Is something wrong?
#124 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
20/100
Issue type
Bug
Clarity
Needs clarification
Activity status
Stale
Tech stack
lua, zsh
Domain
cli

Research direction

Start by reproducing the issue with zsh 5.8, z.lua installed through zinit, and the listed completion, autosuggestion, syntax-highlighting, and oh-my-zsh plugins. Compare completion after z drive_c with the interactive choices from z -i; done means tab completion works reliably in the reported setup or the conflicting component is identified.

Written by the indexing model from the issue text.

Description

I'm using zsh 5.8 (x86_64-pc-linux-gnu) and installed z.lua with the zinit plugin manager. If I understand correctly, tab completion in zsh should work out of the box. However, nothing happens when I press tab after, for example, z drive_c. z -i does give a few choices which means some paths are remembered and available.

❯ zi drive_c   
3:  2          $HOME/wine/prefix1/drive_c/
2:  8          $HOME/wine/prefix2/drive_c/
1:  20         $HOME/wine/prefix3/drive_c/

I'm suspecting some conflicts with other plugins but I only have those most popular ones such as zsh-users/zsh-completions, zsh-users/zsh-autosuggestions, zdharma/fast-syntax-highlighting and some ohmyzsh libs and plugins.

I can provide more details if necessary. Thanks!

Dominant language
Lua
Stars
3.1k
Forks
149
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from skywind3000/z.lua

All issues in skywind3000/z.lua

Similar issues

More Lua issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.