Ir para o conteúdo

Self Plugin Remove

Remove um plugin instalado, excluindo todos os seus comandos do sistema.

Como usar

susa self plugin remove <nome-do-plugin>

Exemplo

# Remove com confirmação
susa self plugin remove backup-tools

# Remove sem confirmação (útil para scripts)
susa self plugin remove backup-tools -y

# Remove modo silencioso sem confirmação
susa self plugin remove backup-tools -y -q

Detecção automática do diretório atual

Se você estiver dentro do diretório de um plugin em modo desenvolvimento e não passar o nome do plugin, o comando automaticamente detecta qual plugin remover:

# Dentro do diretório do plugin dev
cd ~/projetos/meu-plugin
susa self plugin remove
# Detecta automaticamente 'meu-plugin'

# Funciona com flags
susa self plugin remove -y
susa self plugin remove --verbose

Importante: Esta detecção automática funciona apenas para plugins em modo desenvolvimento (instalados com caminho local).

O que acontece?

Plugins Git

  1. Verifica se o plugin existe
  2. Mostra quantos comandos serão removidos
  3. Solicita confirmação
  4. Remove o diretório do plugin
  5. Remove o registro do plugin do sistema
  6. Atualiza o arquivo susa.lock

Plugins Dev (Modo Desenvolvimento)

  1. Verifica se o plugin existe no registry
  2. Mostra modo desenvolvimento e caminho local
  3. Mostra quantos comandos serão removidos
  4. Solicita confirmação
  5. Remove apenas o registro do sistema (não remove arquivos locais)
  6. Atualiza o arquivo susa.lock

Importante: Plugins dev não têm seus arquivos removidos, apenas o registro no sistema.

Processo de remoção

Plugin Git

⚠ Atenção: Você está prestes a remover o plugin 'backup-tools'

Comandos que serão removidos: 4

Deseja continuar? (s/N): s
ℹ Removendo plugin 'backup-tools'...
✓ Plugin 'backup-tools' removido com sucesso!
ℹ Atualizando o lock...

💡 Execute 'susa --help' para ver as categorias atualizadas

Plugin Dev (Modo Desenvolvimento)

⚠ Atenção: Você está prestes a remover o plugin 'meu-plugin'

Modo: desenvolvimento
Local do plugin: /home/usuario/projetos/meu-plugin

Comandos que serão removidos: 3

Deseja continuar? (s/N): s
ℹ Removendo plugin 'meu-plugin'...
✓ Plugin 'meu-plugin' removido com sucesso!
ℹ Atualizando o lock...

💡 Execute 'susa --help' para ver as categorias atualizadas

Nota: Os arquivos do plugin dev permanecem no diretório local.

Confirmação

Por padrão, o comando sempre solicita confirmação antes de remover o plugin.

Para cancelar, pressione N ou Enter.

Pular confirmação

Para automação ou scripts, use a opção -y ou --yes:

# Remove sem pedir confirmação
susa self plugin remove meu-plugin -y

# Útil em scripts de automação
susa self plugin remove meu-plugin --yes -q

Se o plugin não existir

✗ Plugin 'nome-invalido' não encontrado

Use susa self plugin list para ver plugins instalados

Opções

Opção O que faz
-y, --yes Pula confirmação e remove automaticamente
-v, --verbose Ativa logs de debug
-q, --quiet Modo silencioso (mínimo de output)
-h, --help Mostra ajuda

Diferenças entre Plugin Git e Dev

Plugin Git

  • ❌ Remove diretório completo de ~/.susa/plugins/nome-plugin
  • ❌ Remove registro do sistema
  • 🔄 Atualiza susa.lock
  • ⚠️ Permanente - Precisa reinstalar do Git

Plugin Dev

  • ✅ Mantém arquivos no diretório local
  • ❌ Remove apenas registro do sistema
  • 🔄 Atualiza susa.lock
  • 🔄 Reversível - Pode reinstalar com susa self plugin add .

Atenção

⚠️ Para plugins Git, a remoção é permanente. Se precisar do plugin novamente, será necessário reinstalá-lo usando susa self plugin add.

✅ Para plugins dev, os arquivos permanecem no diretório local. Você pode reinstalar a qualquer momento:

cd ~/projetos/meu-plugin
susa self plugin add .

Veja também