🤝 Contributing
Contributions are what make the Z-Shell ecosystem thrive. Whether you want to fix a bug in zi, publish a Zsh plugin, or improve this documentation — you are in the right place.
All contributors are expected to follow our Code of Conduct. Please read it before participating.
Contribution Paths
Choose the path that matches what you want to do:
Contribute to Zi
Fix bugs, add features, improve performance, or improve the zi source code itself.
Create a Zsh Plugin
Write your own Zsh plugin following the community standard and best practices.
Improve the Docs
Add pages, fix typos, improve guides, or help translate the wiki.
Get Involved
| Action | Link |
|---|---|
| 👥 Join the team | Open a membership request |
| 🌐 Translate | translate.zshell.dev |
| 📋 Project tracker | Z-shell Delivery (Project 28) |
| 💬 Discuss | GitHub Discussions |
General Guidelines
Before starting any significant work — open an issue to discuss the change first. This avoids wasted effort and helps the maintainers coordinate.
All repositories in the z-shell organization share a common branch model, commit convention, and project tracker. See Getting Started for the details that apply everywhere.