# Atualizações e ciclo de vida do Skill

Inspecione versões, atualize versões publicadas, gerencie backups e remova com segurança o ambiente de execução local independente do Skill.

- Canonical: https://docs.xmemo.dev/pt-br/docs/skills/updates
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: 9bb22ee041e4d2d333c4d064a36f8f242e3295eeeca0d55e0f8f603286ac6d5f
- Edition-Digest: 6e9e715b368a2f04a57eb1c329dd890abe00372e5a02bad63d424a6a85ebfeb8
- Source-Revision: sha256:e65ff2255a268515f9753f35fa92380db092ac1526ffd5db790e6ee53f7147ec

## Versões distintas do Skill e da CLI

O ambiente de execução independente do Skill e a CLI do XMemo são pacotes independentes com números de versão e ciclos de lançamento separados. Atualizar um deles não modifica automaticamente o outro.

- Pacote de Skill independente: versão 1.1.35 (@xmemo/skill@1.1.35), inspecionável via node scripts/xmemo-skill.mjs --version ou doctor.
- Pacote da CLI do XMemo: versão 0.4.x / 1.x (@xmemo/client@0.4.187), inspecionável via xmemo --version.
- Atualizações independentes: atualizar @xmemo/client via npm atualiza o orquestrador da CLI, mas não altera os diretórios de skills já instalados até que xmemo skill update seja executado.
- Subresource Integrity (SRI): a CLI verifica os arquivos tarball do pacote usando sha512 SRI antes de extrair arquivos para os diretórios de skills do agente.

```bash
# Inspect standalone Skill version:
node scripts/xmemo-skill.mjs --version

# Inspect XMemo CLI version:
xmemo --version

# Inspect detailed runtime health and discovery status:
node scripts/xmemo-skill.mjs doctor
```

## Comandos da CLI para ciclo de vida do skill

A CLI do XMemo fornece comandos dedicados para inspecionar o status da instalação, instalar em clientes de agente, atualizar para versões mais recentes e remover skills com segurança.

- Status: xmemo skill status [--client <id>|--all] [--json] inspeciona skills instalados e informa versão, ID do cliente e caminho de destino.
- Instalar: xmemo skill install [--client <id>|--all] [--project] [--global] [--dir <path>] [--dry-run] [--yes] [--force] [--json].
- Atualizar: xmemo skill update [--client <id>|--all] [--dry-run] [--yes] [--json] atualiza skills instalados para a versão fixada mais recente.
- Remover: xmemo skill remove --client <id> [--project] [--yes] [--json] remove pastas de skill verificadas com segurança.

```bash
# Check status across all detected clients:
xmemo skill status --all

# Update an installed skill with preview:
xmemo skill update --client codex --dry-run
xmemo skill update --client codex --yes

# Install to a specific client:
xmemo skill install --client claude-code --yes
```

## Tratamento de instalações existentes, backups e recuperação

Para evitar substituições acidentais ou perda de personalizações, o instalador se recusa a sobrescrever um diretório existente sem confirmação explícita e preserva backups automaticamente.

- Recusa de substituição: reexecutar install em um diretório de skill existente interrompe a execução e relata uma instalação existente, a menos que --force (ou XMEMO_SKILL_FORCE=1) seja informado.
- Localização automatizada de backups: quando --force ou skill update substitui uma instalação, a versão anterior é movida para ~/.xmemo/backups/skills/<client_id>/<name>-<timestamp> (ou ~/.xmemo/backups/skills/custom/<basename>-<timestamp> para diretórios personalizados).
- Isolamento do carregamento do agente: os backups residem com segurança em ~/.xmemo/backups/, fora dos caminhos ativos de busca de skills do agente, evitando registros duplicados de ferramentas.
- Recuperação: para reverter uma atualização, restaure o diretório de backup preservado de ~/.xmemo/backups/skills/<client_id>/ de volta para a pasta de skills ativa do agente.

```bash
# Force re-install with automatic backup creation:
xmemo skill install --client codex --force --yes

# Inspect preserved backups:
ls -la ~/.xmemo/backups/skills/codex/
```

## O que a remoção deixa para trás

Remover um skill é uma operação no sistema de arquivos local que desvincula o diretório do skill. Isso não apaga suas credenciais, configuração local ou memórias remotas.

- Diretório local do skill removido: xmemo skill remove exclui apenas o diretório verificado xmemo-memory e recusa pastas desconhecidas.
- Credenciais permanecem intactas: ~/.xmemo/skill-credentials.json e a variável de ambiente XMEMO_KEY permanecem inalterados.
- Configuração permanece intacta: as definições locais em ~/.xmemo/ permanecem intactas.
- Memórias remotas permanecem intactas: memórias armazenadas, itens de Knowledge e TODOs no xmemo.dev não são excluídos pela remoção do skill.
- Limpeza completa de credenciais: execute node scripts/xmemo-skill.mjs logout antes da remoção para revogar o token de sessão ativo, ou exclua manualmente ~/.xmemo/skill-credentials.json.
- Exclusão definitiva de memória: memórias remotas permanecem acessíveis até serem excluídas logicamente via node scripts/xmemo-skill.mjs forget --id <id> --confirm ou expurgadas através da Memory Console.

```bash
# Step 1: Revoke active session credentials (optional):
node scripts/xmemo-skill.mjs logout

# Step 2: Remove the installed skill directory:
xmemo skill remove --client codex --yes
```