Dois livros online gratuitos explicam como são projetados e controlados os harnesses de agentes para modelos que escrevem código, como Claude Code e Codex.
microsoft/apm
Gerenciador de dependências para configurações de agentes de programação com IA, que permite às equipes declarar skills, prompts, agentes, plugins e servidores MCP em um único arquivo apm.yml.
- Estrelas
- 4,277
- Forks
- 416
- Issues abertas
- 227
- Último commit
- ontem
O que é?
O APM (Agent Package Manager) traz a lógica de gerenciadores de pacotes para o contexto usado por agentes de programação com IA. Em vez de cada desenvolvedor copiar manualmente instruções, skills, prompts e configurações de servidores MCP para suas ferramentas, o projeto declara esses itens em um manifesto apm.yml, e executar apm install grava as configurações correspondentes para cada agente compatível. Um arquivo de lock, apm.lock.yaml, fixa a árvore de dependências resolvida, incluindo as dependências transitivas, para que todos obtenham a mesma configuração ao clonar o projeto.
Os pacotes podem ser obtidos no GitHub, GitLab, Bitbucket, Azure DevOps e outros hosts Git, e é possível adicionar marketplaces como fontes. Os destinos incluem GitHub Copilot, Claude Code, Cursor, Codex, Gemini, Windsurf, Kiro e outros. O APM também pode compilar instruções em arquivos como .github/copilot-instructions.md e empacotar configurações como bundles padrão plugin.json.
Para segurança e governança, a instalação verifica se há Unicode oculto no contexto dos agentes, os arquivos de lock registram hashes de conteúdo e um arquivo apm-policy.yml pode restringir fontes, escopos e primitivas permitidos. O projeto é escrito em Python e pode ser instalado via Homebrew, pip, WinGet ou Scoop.
Recursos principais
- 01Declare skills, prompts, agentes, instruções, hooks e servidores MCP em um único manifesto apm.yml.
- 02Distribui a mesma configuração para Copilot, Claude, Cursor, Codex, Gemini e outros agentes.
- 03O arquivo de lock fixa toda a árvore de dependências, incluindo as dependências transitivas.
- 04Instala pacotes do GitHub, GitLab, Azure DevOps e outros hosts Git.
- 05Verifica se há Unicode oculto no contexto instalado dos agentes e confere os hashes de conteúdo.
- 06O arquivo de políticas restringe as fontes e primitivas permitidas pela organização.
Casos de uso
- Compartilhar um conjunto consistente de instruções e skills para agentes de programação em um repositório da equipe.
- Reproduzir a mesma configuração de agentes de IA em todas as máquinas de desenvolvimento e no CI.
- Criar e empacotar plugins reutilizáveis para Copilot, Claude ou Cursor.
- Aplicar políticas de fontes aprovadas para configurações de agentes de IA em uma empresa.
Início rápido
- 1
Instale o APM com Homebrew no macOS
brew install apm - 2
Ou instale o APM com pip (Python 3.10 ou superior)
pip install apm-cli - 3
Instale o pacote de exemplo
apm install microsoft/apm-sample-package#v1.0.0
Em coleções
Tópicos
Perguntas frequentes
- O que é apm?
- Gerenciador de dependências para configurações de agentes de programação com IA, que permite às equipes declarar skills, prompts, agentes, plugins e servidores MCP em um único arquivo apm.yml. O APM (Agent Package Manager) traz a lógica de gerenciadores de pacotes para o contexto usado por agentes de programação com IA. Em vez de cada desenvolvedor copiar manualmente instruções, skills, prompts e configurações de servidores MCP para suas ferramentas, o projeto declara esses itens em um manifesto apm.yml, e executar apm install grava as configurações correspondentes para cada agente compatível. Um arquivo de lock, apm.lock.yaml, fixa a árvore de dependências resolvida, incluindo as dependências transitivas, para que todos obtenham a mesma configuração ao clonar o projeto.
- apm é gratuito? Qual é a licença?
- apm é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- apm ainda é mantido?
- Manutenção ativa. O último commit de apm foi em 6 de nov. de 2026.
- Para que posso usar apm?
- Compartilhar um conjunto consistente de instruções e skills para agentes de programação em um repositório da equipe. Reproduzir a mesma configuração de agentes de IA em todas as máquinas de desenvolvimento e no CI. Criar e empacotar plugins reutilizáveis para Copilot, Claude ou Cursor. Aplicar políticas de fontes aprovadas para configurações de agentes de IA em uma empresa.
- Como instalar apm?
- Instale o APM com Homebrew no macOS: brew install apm Ou instale o APM com pip (Python 3.10 ou superior): pip install apm-cli Instale o pacote de exemplo: apm install microsoft/apm-sample-package#v1.0.0
- Onde consigo apm?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/microsoft/apm
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um catálogo local e plano de controle para Codex ou Claude pesquisarem mais de 2.700 playbooks SKILL.md, selecionarem skills específicas, validarem uma stack e visualizarem um plano de instalação.
Uma camada de contexto que aprende com o uso e dá a agentes de programação, como Claude Code e Cursor, um mapa do código e das decisões da equipe sobre ele.
Uma coleção comunitária de agentes personalizados, instruções, skills, hooks, workflows e plugins para personalizar o GitHub Copilot.
Um monitor de terminal no estilo btop que mostra em tempo real o uso de tokens, a janela de contexto, os limites de uso e as portas abertas nas sessões do Claude Code, Codex CLI e OpenCode.
Proxy local e visualizador de traces que captura o tráfego de API de agentes de programação com IA, como Claude Code e Codex CLI, para inspecionar prompts, chamadas de ferramentas e uso de tokens.