Zi

Gérez vos plugins Zsh, vos snippets et vos outils en ligne de commande.

Démarrage rapide  ·  Documentation  ·  Versions  ·  Discussions

Zi est le gestionnaire de plugins de l'écosystème Z-Shell, anciennement connu sous les noms zplugin et zinit.

Fonctionnalités

• Démarrage réactif : différez le chargement des plugins jusqu'après le premier prompt grâce au mode Turbo.
• Sources flexibles : chargez des plugins, des scripts, des complétions et des artefacts de version.
• Contrôle du chargement : utilisez les modificateurs ice pour configurer les téléchargements, les compilations et les mises à jour.
• Gestion des outils : installez des outils en ligne de commande sans accès root.
• Extensions : ajoutez des capacités via les annexes de Zi.

Prérequis

Utilisez Zsh avec Git disponible dans le PATH. L'installateur de démarrage rapide utilise également curl et un shell POSIX. Les plugins et outils que vous installez peuvent avoir leurs propres dépendances.

Démarrage rapide

1. Installer Zi

L'installateur officiel installe Zi avec le profil de chargeur par défaut et ajoute une courte entrée de source gérée à .zshrc (voir la page d'installation canonique) :

sh -c "$(curl -fsSL get.zshell.dev)" --

[!IMPORTANT] Examinez la source de l'installateur et sa somme de contrôle SHA-256 publiée avant d'exécuter un script d'installation distant.

2. Ajouter vos premiers plugins

Ajoutez ces commandes à .zshrc après l'entrée de source gérée de l'installateur. Cet exemple charge un snippet Oh My Zsh, des suggestions de commandes et une coloration syntaxique rapide :

# ~/.zshrc
zi snippet OMZ::plugins/git/git.plugin.zsh
zi light zsh-users/zsh-autosuggestions
zi light z-shell/F-Sy-H

snippet charge un script autonome. light charge un plugin. Le premier chargement télécharge les dépôts ou snippets manquants.

3. Recharger Zsh

exec zsh -il

Exécutez zi -h pour explorer les commandes disponibles. Pour les installateurs alternatifs, la configuration manuelle, les complétions et les étapes post-installation, consultez le guide d'installation complet.

Apprendre par tâche

• Charger des plugins et des snippets : vue d'ensemble générale.
• Choisir comment les dépendances se chargent : modificateurs ice.
• Configurer les chemins et le comportement : guide de configuration.
• Mettre à jour, inspecter et décharger : référence des commandes.
• Trouver des plugins et des annexes : catalogue de l'écosystème.
• Comprendre le démarrage du shell : référence officielle des fichiers de démarrage Zsh.

Pour les installateurs automatisés et les interfaces terminal, utilisez le contrat d'intégration de configuration, incluant les phases plan/apply, les résultats et la gestion des événements.

Communauté et support

• Posez vos questions d'utilisation dans les Discussions Z-Shell.
• Signalez les défauts reproductibles via les issues Zi.
• Parcourez les versions et les journaux de modifications sur la page des versions.
• Explorez la organisation Z-Shell dans son ensemble.

Contribuer

Les contributions sont les bienvenues. Lisez le guide de contribution pour le modèle de branches et le processus de publication avant d'ouvrir une issue ou une pull request. Consultez le workflow Zsh pour la syntaxe et les vérifications de régression ciblées utilisées pour valider un checkout. Le travail de développement cible la branche next, tandis que main contient les versions de production.

Sécurité

Veuillez suivre la politique de sécurité Z-Shell pour signaler les vulnérabilités en privé. Ne divulguez pas une vulnérabilité dans une issue publique avant qu'un correctif ne soit disponible.

Licence

Zi est disponible sous la licence MIT.