Apothem v1.0.1 — lançamento de estreia

O Apothem v1.0.1 é o lançamento de estreia do gerenciador de configuração agnóstico ao host para harnesses de assistentes de IA: um único perfil compartilhado, dezessete harnesses, uma única versão assinada e evidência de cadeia de suprimentos anexada ao próprio lançamento.

A tese: um perfil, dezessete harnessesCopy Anchor Link

O Apothem lê um único perfil compartilhado em ~/.config/apothem/profile.yaml e o materializa na configuração nativa que cada harness espera. Você escreve suas regras de comportamento, skills, hooks e convenções uma única vez. O Apothem as renderiza em dezessete alvos nativos de harness e os mantém em sincronia.

Os dezessete adaptadores neste lançamento:

• antigravity
• claude-code
• codebuddy
• codex
• cursor
• gemini-cli
• github-copilot
• glm
• hermes
• kimi-code
• kiro
• open-claw
• opencode
• qwen-code
• trae
• windsurf
• zed

Adicione uma ferramenta ao seu fluxo de trabalho, execute um comando e sua configuração estará lá. Remova uma ferramenta, e o Apothem remove os arquivos que ele gravou; a memória compartilhada, os contextos e os armazenamentos de aprendizado são removidos junto com o último harness, após um backup, e plans/ permanece sempre.

InstalaçãoCopy Anchor Link

Várias rotas de instalação, uma única CLI por baixo:

1. Plugin do Claude Code — dentro do Claude Code:

   Copy Text

   /plugin marketplace add ahmed-g-gad/apothem
   /plugin install apothem@apothem

2. npx — execute a CLI diretamente do pacote npm @ahmed-g-gad/apothem, sem etapa de instalação:

   Copy Text

   npx @ahmed-g-gad/apothem profile init
   npx @ahmed-g-gad/apothem install --harness all --project .

3. Instalador de script de uma única etapa — coloca um runtime autocontido e um lançador apothem (~/.local/bin/apothem em POSIX, com uma dica de PATH quando esse diretório não estiver em PATH; apothem.cmd em WindowsApps no Windows):

   Copy Text

   curl -fsSL https://apothem.ahmedgad.com/install.sh | sh    # POSIX

   O script POSIX verifica por padrão a assinatura GPG da tag de lançamento e aborta quando a chave do mantenedor não está no chaveiro local. Até que o mantenedor publique a impressão digital da chave (consulte SECURITY.md), defina APOTHEM_VERIFY=checksum para conferir o arquivo com o SHA256SUMS do lançamento, ou APOTHEM_ALLOW_UNVERIFIED=1 para prosseguir sem a verificação da tag.

   Copy Text

   irm https://apothem.ahmedgad.com/install.ps1 | iex         # Windows

4. Plugins e extensões nativos de cada ferramenta — uma extensão do Gemini CLI (gemini extensions install https://github.com/ahmed-g-gad/apothem), uma extensão do Qwen Code (qwen extensions install ahmed-g-gad/apothem) e um plugin do Codex (codex plugin marketplace add ahmed-g-gad/apothem). O código-fonte de uma extensão da família VS Code, abrangendo VS Code e GitHub Copilot, está na pasta vscode-extension/ do repositório. Ela não está listada no Visual Studio Marketplace, e este lançamento não anexa nenhum pacote .vsix.

Postura de cadeia de suprimentosCopy Anchor Link

A GitHub Release v1.0.1 carrega o conjunto completo de evidências ao lado do código:

• sdist e wheel, conferidos antes da publicação.
• Um SBOM CycloneDX.
• Pacotes de assinatura sem chave do Sigstore cosign para o sdist, o wheel e os arquivos por plataforma.
• Proveniência de build SLSA-3, verificada dentro do próprio fluxo de trabalho do lançamento.
• Arquivos de runtime por plataforma (darwin / linux / windows) com um manifesto SHA256SUMS assinado.

O commit do lançamento é assinado com GPG (v1.0.1 é uma tag leve, sem assinatura própria), e o pacote npm foi publicado com proveniência de build do Sigstore gerada no GitHub Actions.

O que vem na caixaCopy Anchor Link

A CLI apothem expõe os comandos de operador de que você precisa para o ciclo de vida completo da configuração:

• apothem install — materializa o perfil em um harness ou em todos eles.
• apothem uninstall — remove a configuração materializada de um harness, deixando o perfil compartilhado intocado.
• apothem update — re-materializa depois que você edita o perfil.
• apothem verify — detecta desvio entre o perfil e a configuração em disco de um harness.
• apothem harnesses — lista cada adaptador registrado.
• apothem profile — inspeciona e gerencia o perfil compartilhado.
• apothem doctor — diagnostica problemas de ambiente e configuração.

Cada adaptador de harness implementa um protocolo HarnessAdapter uniforme — install, update, uninstall, is_installed, verify — para que cada harness se comporte de forma previsível do ponto de vista do operador, independentemente do formato do fornecedor por baixo. Leia mais sobre o design em o mergulho técnico na arquitetura do adaptador e sobre a reconciliação de formatos em convergência de convenções entre harnesses.

Para onde ir em seguidaCopy Anchor Link

• Início rápido — instale e materialize seu primeiro perfil.
• Harnesses — referência por adaptador para todos os dezessete alvos.
• Conceitos — o modelo de perfil e o pipeline de materialização.

O Apothem é licenciado sob MIT e desenvolvido abertamente em github.com/ahmed-g-gad/apothem.