Skip to content
Apothem
Instalação

Atualização

Atualize o Apothem e os adaptadores de ferramenta.

Atualizar o plugin do Claude Code

Atualize a listagem do marketplace e, em seguida, atualize o plugin pelo menu /plugin dentro do Claude Code:

Inside Claude Code
/plugin marketplace update apothem

Abra /plugin, selecione apothem e escolha a ação de atualização quando uma versão mais recente do plugin estiver listada.

O npx sempre executa a versão atual

npx @ahmed-g-gad/apothem resolve o pacote publicado atual a cada execução, então não há nada a atualizar. Quando um cache desatualizado do npx serve uma cópia mais antiga, fixe a dist-tag explicitamente:

npx @ahmed-g-gad/apothem@latest --version

Atualizar uma configuração baseada em instalador

Execute o instalador novamente — ele é idempotente e faz o checkout da tag de lançamento em uma árvore existente — ou execute o script de atualização dedicado:

macOS · Linux · WSL2 · BSD
bash scripts/installer/update.sh
Windows · PowerShell
pwsh -NoProfile -File scripts/installer/update.ps1

O script de atualização refaz o checkout da árvore de código-fonte em APOTHEM_HOME (padrão ~/.apothem) para APOTHEM_REF: quando não definido, resolve a tag de lançamento vMAJOR.MINOR.PATCH assinada mais recente; um valor de tag a fixa; e main seleciona a branch móvel somente quando APOTHEM_ALLOW_UNVERIFIED=1 também está definido. Sem essa substituição, a atualização faz o checkout da ref e então aborta antes de rematerializar, porque uma branch não é uma tag de lançamento assinada. Ele verifica a assinatura da tag com git verify-tag antes de rematerializar; uma tag não assinada ou adulterada aborta a operação, a menos que APOTHEM_ALLOW_UNVERIFIED=1 rebaixe o aborto para um aviso. Uma tag assinada cuja chave pública do mantenedor está ausente do chaveiro local aborta com orientação para importar a chave, apontando para a impressão digital publicada em SECURITY.md. Em seguida, ele rematerializa o harness nomeado por APOTHEM_HARNESS, executando apothem update a partir da árvore atualizada (os padrões do harness seguem a tabela de variáveis de ambiente do instalador). Ele exige uma instalação prévia: quando não existe árvore em APOTHEM_HOME e APOTHEM_SOURCE não está definido, ele sai com uma mensagem que direciona você ao instalador primeiro.

Rematerializar a saída de harness

Após atualizar o motor ou editar ~/.config/apothem/profile.yaml, rederive a configuração de harness instalada. Adaptadores com escopo de usuário não precisam de --project; adaptadores com escopo de projeto precisam.

apothem update --harness claude-code
apothem update --harness cursor --project /path/to/project
apothem update --harness all --project /path/to/project

Execute o mesmo comando com --dry-run --json quando precisar de uma prévia legível por máquina sem gravações no sistema de arquivos.

Limite do comando atual

apothem update atualiza apenas a saída de harness. A CLI não implementa update --self, update --check ou update --apply; atualize o próprio motor pelo canal com que você instalou — o fluxo /plugin, uma nova execução npx ou os scripts de instalador/atualização acima.

Verificar a versão do motor

apothem --version
npx @ahmed-g-gad/apothem --version

On this page