Zi

Gerencie seus plugins, snippets e ferramentas de linha de comando do Zsh.

Início rápido  ·  Documentação  ·  Versões  ·  Discussões

Zi é o gerenciador de plugins do ecossistema Z-Shell, anteriormente conhecido como zplugin e zinit.

Recursos

• Inicialização responsiva: adie o carregamento de plugins até depois do primeiro prompt com o modo Turbo.
• Fontes flexíveis: carregue plugins, scripts, completions e artefatos de release.
• Controle sobre o carregamento: use modificadores ice para configurar downloads, builds e atualizações.
• Gerenciamento de ferramentas: instale ferramentas de linha de comando sem acesso root.
• Extensões: adicione capacidades por meio dos annexes do Zi.

Requisitos

Use Zsh com Git disponível no PATH. O instalador de início rápido também usa curl e um shell POSIX. Os plugins e ferramentas que você instalar podem ter suas próprias dependências.

Início rápido

1. Instale o Zi

O instalador oficial instala o Zi com o perfil de loader padrão e adiciona uma pequena entrada de source gerenciada ao .zshrc (consulte a página de instalação canônica):

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

[!IMPORTANT] Revise o código-fonte do instalador e seu checksum SHA-256 publicado antes de executar um script de instalação remoto.

2. Adicione seus primeiros plugins

Adicione estes comandos ao .zshrc após a entrada de source gerenciada pelo instalador. Este exemplo carrega um snippet do Oh My Zsh, sugestões de comandos e realce de sintaxe 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 carrega um script autônomo. light carrega um plugin. O primeiro carregamento baixa quaisquer repositórios ou snippets ausentes.

3. Recarregue o Zsh

exec zsh -il

Execute zi -h para explorar os comandos disponíveis. Para instaladores alternativos, configuração manual, completions e etapas pós-instalação, consulte o guia de instalação completo.

Aprenda por tarefa

• Carregar plugins e snippets: visão geral.
• Escolher como as dependências carregam: modificadores ice.
• Configurar caminhos e comportamento: guia de configuração.
• Atualizar, inspecionar e descarregar: referência de comandos.
• Encontrar plugins e annexes: catálogo do ecossistema.
• Entender a inicialização do shell: referência oficial de arquivos de inicialização do Zsh.

Para instaladores automatizados e interfaces de terminal, use o contrato de integração de setup, incluindo fases de plan/apply, resultados e tratamento de eventos.

Comunidade e suporte

• Faça perguntas de uso nas Z-Shell Discussions.
• Relate defeitos reproduzíveis por meio das issues do Zi.
• Navegue pelas versões e changelogs na página de releases.
• Explore a ampla organização Z-Shell.

Contribuindo

Contribuições são bem-vindas. Leia o guia de contribuição para conhecer o modelo de branches e o processo de release antes de abrir uma issue ou pull request. Consulte o workflow do Zsh para as verificações de sintaxe e regressão focadas usadas para validar um checkout. O trabalho de desenvolvimento é direcionado ao branch next, enquanto main contém as versões de produção.

Segurança

Siga a política de segurança do Z-Shell para relatar vulnerabilidades de forma privada. Não divulgue uma vulnerabilidade em uma issue pública antes que uma correção esteja disponível.

Licença

Zi está disponível sob a Licença MIT.