Zi

Gestiona tus plugins de Zsh, fragmentos de código y herramientas de línea de comandos.

Inicio rápido  ·  Documentación  ·  Versiones  ·  Debates

Zi es el gestor de plugins del ecosistema Z-Shell, anteriormente conocido como zplugin y zinit.

Características

• Inicio receptivo: aplaza la carga de plugins hasta después del primer prompt con el modo Turbo.
• Fuentes flexibles: carga plugins, scripts, completados y artefactos de versiones.
• Control sobre la carga: usa modificadores ice para configurar descargas, compilaciones y actualizaciones.
• Gestión de herramientas: instala herramientas de línea de comandos sin acceso root.
• Extensiones: añade capacidades mediante los anexos de Zi.

Requisitos

Usa Zsh con Git disponible en el PATH. El instalador de inicio rápido también usa curl y un shell POSIX. Los plugins y herramientas que instales pueden tener sus propias dependencias.

Inicio rápido

1. Instalar Zi

El instalador oficial instala Zi con el perfil de cargador predeterminado y añade una breve entrada de origen gestionada a .zshrc (consulta la página de instalación canónica):

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

[!IMPORTANT] Revisa el código fuente del instalador y su suma de verificación SHA-256 publicada antes de ejecutar un script de instalación remoto.

2. Añade tus primeros plugins

Añade estos comandos a .zshrc después de la entrada de origen gestionada del instalador. Este ejemplo carga un fragmento de Oh My Zsh, sugerencias de comandos y resaltado de sintaxis rápido:

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

snippet carga un script independiente. light carga un plugin. La primera carga descarga los repositorios o fragmentos que falten.

3. Recarga Zsh

exec zsh -il

Ejecuta zi -h para explorar los comandos disponibles. Para instaladores alternativos, configuración manual, completados y pasos posteriores a la instalación, consulta la guía de instalación completa.

Aprende por tarea

• Cargar plugins y fragmentos: descripción general.
• Elegir cómo se cargan las dependencias: modificadores ice.
• Configurar rutas y comportamiento: guía de configuración.
• Actualizar, inspeccionar y descargar: referencia de comandos.
• Encontrar plugins y anexos: catálogo del ecosistema.
• Entender el inicio del shell: referencia oficial de archivos de inicio de Zsh.

Para instaladores automatizados e interfaces de terminal, usa el contrato de integración de configuración, que incluye las fases de planificación/aplicación, los resultados y el manejo de eventos.

Comunidad y soporte

• Formula preguntas de uso en Z-Shell Discussions.
• Informa de defectos reproducibles a través de Zi issues.
• Explora versiones y registros de cambios en la página de versiones.
• Explora la amplia organización Z-Shell.

Contribuir

Las contribuciones son bienvenidas. Lee la guía de contribución para conocer el modelo de ramas y el proceso de publicación antes de abrir una incidencia o una solicitud de cambios. Consulta el flujo de trabajo de Zsh para las comprobaciones de sintaxis y regresión específicas que se usan para verificar una copia de trabajo. El trabajo de desarrollo se dirige a la rama next, mientras que main contiene las versiones de producción.

Seguridad

Sigue la política de seguridad de Z-Shell para informar de vulnerabilidades de forma privada. No divulgues una vulnerabilidad en una incidencia pública antes de que haya una corrección disponible.

Licencia

Zi está disponible bajo la Licencia MIT.