🤝 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.

Code of Conduct

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 ZiFix bugs, add features, improve performance, or improve the zi source code itself.Contributing to Zi →

Create a Zsh PluginWrite your own Zsh plugin following the community standard and best practices.Zsh Plugin Standard →

Improve the DocsAdd pages, fix typos, improve guides, or help translate the wiki.Contributing to the Wiki →

Get Involved

Action	Link
👥 Join the team	Open a membership request
🌐 Translate	translate.zshell.dev
📋 Project tracker	Z-Shell Tracker
💬 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.