Skip to Content
DocumentaçãoUninstallation

Guia de Desinstalação

🌐 EN | PT | ES

Este guia fornece instruções completas para desinstalar o Synkra AIOS do seu sistema.

Índice

  1. Antes de Desinstalar
  2. Desinstalação Rápida
  3. Desinstalação Completa
  4. Desinstalação Seletiva
  5. Preservação de Dados
  6. Remoção Limpa do Sistema
  7. Resolução de Problemas na Desinstalação
  8. Limpeza Pós-Desinstalação
  9. Reinstalação

Antes de Desinstalar

Considerações Importantes

Aviso: Desinstalar o Synkra AIOS irá:

  • Remover todos os arquivos do framework
  • Excluir configurações de agentes (a menos que preservadas)
  • Limpar dados da camada de memória (a menos que backup seja feito)
  • Remover todos os workflows personalizados
  • Excluir logs e arquivos temporários

Checklist Pré-Desinstalação

  • Fazer backup de dados importantes
  • Exportar agentes e workflows personalizados
  • Salvar chaves de API e configurações
  • Documentar modificações personalizadas
  • Parar todos os processos em execução
  • Informar membros da equipe

Faça Backup dos Seus Dados

# Criar backup completo
npx @synkra/aios-core backup --complete
 
# Ou fazer backup manual dos diretórios importantes
tar -czf aios-backup-$(date +%Y%m%d).tar.gz \
  .aios/ \
  agents/ \
  workflows/ \
  tasks/ \
  --exclude=.aios/logs \
  --exclude=.aios/cache

Desinstalação Rápida

Usando o Desinstalador Integrado

A forma mais rápida de desinstalar o Synkra AIOS:

# Desinstalação básica (preserva dados do usuário)
npx @synkra/aios-core uninstall
 
# Desinstalação completa (remove tudo)
npx @synkra/aios-core uninstall --complete
 
# Desinstalação com preservação de dados
npx @synkra/aios-core uninstall --keep-data

Desinstalação Interativa

Para desinstalação guiada:

npx @synkra/aios-core uninstall --interactive

Isso solicitará:

  • O que manter/remover
  • Opções de backup
  • Confirmação para cada etapa

Desinstalação Completa

Etapa 1: Parar Todos os Serviços

# Parar todos os agentes em execução
*deactivate --all
 
# Parar todos os workflows
*stop-workflow --all
 
# Encerrar o meta-agent
*shutdown

Etapa 2: Exportar Dados Importantes

# Exportar configurações
*export config --destination backup/config.json
 
# Exportar agentes
*export agents --destination backup/agents/
 
# Exportar workflows
*export workflows --destination backup/workflows/
 
# Exportar dados de memória
*export memory --destination backup/memory.zip

Etapa 3: Executar o Desinstalador

# Remoção completa
npx @synkra/aios-core uninstall --complete --no-backup

Etapa 4: Remover Instalação Global

# Remover pacote npm global
npm uninstall -g @synkra/aios-core
 
# Remover cache do npx
npm cache clean --force

Etapa 5: Limpar Arquivos do Sistema

Windows

# Remover arquivos do AppData
Remove-Item -Recurse -Force "$env:APPDATA\@synkra/aios-core"
 
# Remover arquivos temporários
Remove-Item -Recurse -Force "$env:TEMP\aios-*"
 
# Remover entradas do registro (se houver)
Remove-Item -Path "HKCU:\Software\Synkra AIOS" -Recurse

macOS/Linux

# Remover arquivos de configuração
rm -rf ~/.aios
rm -rf ~/.config/@synkra/aios-core
 
# Remover cache
rm -rf ~/.cache/@synkra/aios-core
 
# Remover arquivos temporários
rm -rf /tmp/aios-*

Desinstalação Seletiva

Remover Componentes Específicos

# Remover apenas agentes
npx @synkra/aios-core uninstall agents
 
# Remover apenas workflows
npx @synkra/aios-core uninstall workflows
 
# Remover camada de memória
npx @synkra/aios-core uninstall memory-layer
 
# Remover agente específico
*uninstall agent-name

Manter o Core, Remover Extensões

# Remover todos os plugins
*plugin remove --all
 
# Remover Squads
rm -rf Squads/
 
# Remover templates personalizados
rm -rf templates/custom/

Preservação de Dados

O Que Manter

Antes de desinstalar, identifique o que você quer preservar:

  1. Agentes Personalizados

    # Copiar agentes personalizados
cp -r agents/custom/ ~/aios-backup/agents/

  2. Workflows e Tasks

    # Copiar workflows
cp -r workflows/ ~/aios-backup/workflows/
cp -r tasks/ ~/aios-backup/tasks/

  3. Dados de Memória

    # Exportar banco de dados de memória
*memory export --format sqlite \
  --destination ~/aios-backup/memory.db

  4. Configurações

    # Copiar todos os arquivos de configuração
cp .aios/config.json ~/aios-backup/
cp .env ~/aios-backup/

  5. Código Personalizado

    # Encontrar e fazer backup de arquivos personalizados
find . -name "*.custom.*" -exec cp {} ~/aios-backup/custom/ \;

Script de Preservação

Crie preserve-data.sh:

#!/bin/bash
BACKUP_DIR="$HOME/aios-backup-$(date +%Y%m%d-%H%M%S)"
 
echo "Criando diretório de backup: $BACKUP_DIR"
mkdir -p "$BACKUP_DIR"
 
# Função de backup
backup_if_exists() {
    if [ -e "$1" ]; then
        echo "Fazendo backup de $1..."
        cp -r "$1" "$BACKUP_DIR/"
    fi
}
 
# Backup de todos os dados importantes
backup_if_exists ".aios"
backup_if_exists "agents"
backup_if_exists "workflows"
backup_if_exists "tasks"
backup_if_exists "templates"
backup_if_exists ".env"
backup_if_exists "package.json"
 
echo "Backup concluído em: $BACKUP_DIR"

Remoção Limpa do Sistema

Script de Limpeza Completa

Crie clean-uninstall.sh:

#!/bin/bash
echo "Desinstalação Completa do Synkra AIOS"
echo "================================="
 
# Confirmação
read -p "Isso removerá TODOS os dados do Synkra AIOS. Continuar? (y/N) " -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
    exit 1
fi
 
# Parar todos os processos
echo "Parando todos os processos..."
pkill -f "@synkra/aios-core" || true
pkill -f "aios-developer" || true
 
# Remover arquivos do projeto
echo "Removendo arquivos do projeto..."
rm -rf .aios/
rm -rf agents/
rm -rf workflows/
rm -rf tasks/
rm -rf templates/
rm -rf Squads/
rm -rf node_modules/@synkra/aios-core/
 
# Remover arquivos globais
echo "Removendo arquivos globais..."
npm uninstall -g @synkra/aios-core
 
# Remover dados do usuário
echo "Removendo dados do usuário..."
rm -rf ~/.aios
rm -rf ~/.config/@synkra/aios-core
rm -rf ~/.cache/@synkra/aios-core
 
# Limpar cache do npm
echo "Limpando cache do npm..."
npm cache clean --force
 
# Remover do package.json
echo "Atualizando package.json..."
npm uninstall @synkra/aios-core/core
npm uninstall @synkra/aios-core/memory
npm uninstall @synkra/aios-core/meta-agent
 
echo "Desinstalação concluída!"

Limpeza do Registro (Windows)

# Script PowerShell para limpeza no Windows
Write-Host "Limpando Synkra AIOS do Registro do Windows..."
 
# Remover do PATH
$path = [Environment]::GetEnvironmentVariable("PATH", "User")
$newPath = ($path.Split(';') | Where-Object { $_ -notmatch '@synkra/aios-core' }) -join ';'
[Environment]::SetEnvironmentVariable("PATH", $newPath, "User")
 
# Remover chaves do registro
Remove-ItemProperty -Path "HKCU:\Environment" -Name "AIOS_*" -ErrorAction SilentlyContinue
 
# Remover associações de arquivo
Remove-Item -Path "HKCU:\Software\Classes\.aios" -Recurse -ErrorAction SilentlyContinue
 
Write-Host "Limpeza do registro concluída!"

Resolução de Problemas na Desinstalação

Problemas Comuns

1. Permissão Negada

# Linux/macOS
sudo npx @synkra/aios-core uninstall --complete
 
# Windows (Executar como Administrador)
npx @synkra/aios-core uninstall --complete

2. Processo Ainda em Execução

# Forçar parada de todos os processos
# Linux/macOS
killall -9 node
killall -9 @synkra/aios-core
 
# Windows
taskkill /F /IM node.exe
taskkill /F /IM @synkra/aios-core.exe

3. Arquivos Bloqueados

# Encontrar processos usando os arquivos
# Linux/macOS
lsof | grep aios
 
# Windows (PowerShell)
Get-Process | Where-Object {$_.Path -like "*aios*"}

4. Remoção Incompleta

# Limpeza manual
find . -name "*aios*" -type d -exec rm -rf {} +
find . -name "*.aios*" -type f -delete

Desinstalação Forçada

Se a desinstalação normal falhar:

#!/bin/bash
# force-uninstall.sh
echo "Desinstalação forçada do Synkra AIOS..."
 
# Matar todos os processos relacionados
pkill -9 -f aios || true
 
# Remover todos os arquivos
rm -rf .aios* aios* *aios*
rm -rf agents workflows tasks templates
rm -rf node_modules/@synkra/aios-core
rm -rf ~/.aios* ~/.config/aios* ~/.cache/aios*
 
# Limpar npm
npm cache clean --force
npm uninstall -g @synkra/aios-core
 
echo "Desinstalação forçada concluída!"

Limpeza Pós-Desinstalação

1. Verificar Remoção

# Verificar arquivos restantes
find . -name "*aios*" 2>/dev/null
find ~ -name "*aios*" 2>/dev/null
 
# Verificar pacotes npm
npm list -g | grep aios
npm list | grep aios
 
# Verificar processos em execução
ps aux | grep aios

2. Limpar Variáveis de Ambiente

# Remover do .bashrc/.zshrc
sed -i '/AIOS_/d' ~/.bashrc
sed -i '/@synkra/aios-core/d' ~/.bashrc
 
# Remover de arquivos .env
find . -name ".env*" -exec sed -i '/AIOS_/d' {} \;

3. Atualizar Arquivos do Projeto

// Remover do package.json scripts
{
  "scripts": {
    // Remover estas entradas
    "aios": "@synkra/aios-core",
    "meta-agent": "@synkra/aios-core meta-agent"
  }
}

4. Limpar Repositório Git

# Remover hooks git específicos do AIOS
rm -f .git/hooks/*aios*
 
# Atualizar .gitignore
sed -i '/.aios/d' .gitignore
sed -i '/aios-/d' .gitignore
 
# Commitar remoção
git add -A
git commit -m "Remove Synkra AIOS"

Reinstalação

Após Desinstalação Completa

Se você quiser reinstalar o Synkra AIOS:

  1. Aguardar a limpeza

    # Garantir que todos os processos pararam
sleep 5

  2. Limpar cache do npm

    npm cache clean --force

  3. Instalação limpa

    npx @synkra/aios-core@latest init my-project

Restaurar a partir do Backup

# Restaurar dados salvos
cd my-project
 
# Restaurar configurações
cp ~/aios-backup/config.json .aios/
 
# Restaurar agentes
cp -r ~/aios-backup/agents/* ./agents/
 
# Importar memória
*memory import ~/aios-backup/memory.zip
 
# Verificar restauração
*doctor --verify-restore

Checklist de Verificação de Desinstalação

  • Todos os processos AIOS parados
  • Arquivos do projeto removidos
  • Pacote npm global desinstalado
  • Arquivos de configuração do usuário excluídos
  • Diretórios de cache limpos
  • Variáveis de ambiente removidas
  • Entradas do registro limpas (Windows)
  • Repositório git atualizado
  • Nenhum arquivo AIOS restante encontrado
  • PATH do sistema atualizado

Obtendo Ajuda

Se você encontrar problemas durante a desinstalação:

  1. Consulte a Documentação

  2. Suporte da Comunidade

    • Discord: #uninstall-help
    • GitHub Issues: Rotule com “uninstall”

  3. Suporte de Emergência

    # Gerar relatório de desinstalação
npx @synkra/aios-core diagnose --uninstall > uninstall-report.log

Lembre-se: Sempre faça backup dos seus dados antes de desinstalar. O processo de desinstalação é irreversível, e a recuperação de dados pode não ser possível sem backups adequados.

TroubleshootingVersioning And Releases