Atualizações e ciclo de vida do Skill

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.

# 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.

# 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.

# 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.

# 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

Atualizações e ciclo de vida do Skill

As Skills são o canal de instruções e comandos para agentes que não montam diretamente um servidor MCP hospedado.

Abrir XMemo Skills

Origem: XMemo Skills