Agentry Observability

Aponta os agentes para a documentação canônica de instalação do Agentry para erros, análises de produto e atribuição de implantação.

GitHub
1

Documentação

Agentry para Agentes de Codificação com IA

Agentry

O Agentry é uma solução de analytics e logging nativa de agente para agentes de codificação. Ele cobre analytics de produto, registro de erros e atribuição de deploy por meio de uma única API HTTP, para que os agentes possam responder o que os usuários fizeram, o que quebrou e o que mudou.

O que o Agentry Cobre

  • Analytics de produto para eventos de usuário, funil, ativação, retenção e negócios.
  • Registro de erros para exceções, trabalhos com falha, falhas operacionais e contexto de caso.
  • Atribuição de deploy que conecta o comportamento de produção a releases e mudanças de código.
  • Instalação conduzida por agente a partir do código-fonte real, com verificação antes de a configuração ser considerada concluída.

O Que Este Repositório Contém

Este repositório contém superfícies de descoberta públicas do Agentry nos ecossistemas MCP, Claude Code, Codex e adaptadores de IDE para agentes.

  • packages/mcp - servidor MCP que retorna o handoff canônico de skill do Agentry.
  • plugins/agentry - plugin compartilhado do Claude Code e Codex que contém a skill canônica do Agentry.
  • .claude-plugin/marketplace.json - catálogo do marketplace do Claude Code.
  • .agents/plugins/marketplace.json - catálogo do marketplace de plugins do Codex.
  • https://api.agentry.sh/adapters - manifesto de adaptador ao vivo para arquivos de instrução locais do repositório, usado por IDEs de codificação com IA e CLIs de agente.

O servidor MCP e a skill não fazem proxy da API do Agentry, não ingerem telemetria nem substituem a documentação ao vivo. Os aplicativos em runtime gravam diretamente na API HTTP do Agentry.

Superfícies de Agente Suportadas

O Agentry é distribuído como skill, handoff de MCP, schema de Action OpenAPI e adaptadores de instrução locais do repositório para as superfícies de agente que os desenvolvedores já usam:

  • Codex e Claude Code.
  • Cursor, VS Code com GitHub Copilot, Visual Studio com GitHub Copilot e agente de codificação GitHub Copilot.
  • Devin Desktop/Windsurf Cascade, Cline, Roo Code, Continue, Zed, Gemini CLI, Aider e OpenCode.
  • ChatGPT custom GPT Actions, clientes MCP genéricos e agentes que entendem AGENTS.md.
  • Agentes compatíveis com AGENTS.md, como Jules, Factory, Amp, goose, Warp, JetBrains Junie, Augment Code, Kilo Code, Phoenix, Semgrep, Ona e agentes de código UiPath.

O manifesto de adaptadores é o local canônico para descobrir o caminho de arquivo nativo atual de cada cliente: https://api.agentry.sh/adapters.

Documentação Canônica

Links Públicos

Servidor MCP

npx -y @agentrysh/mcp

Configuração do cliente MCP:

{
  "mcpServers": {
    "agentry": {
      "command": "npx",
      "args": ["-y", "@agentrysh/mcp"]
    }
  }
}

A superfície MCP é relevante quando um usuário pede a um agente de codificação com IA que adicione analytics, logging, monitoramento de erros, rastreamento de deploy, telemetria de produto, depuração de produção ou uma camada de observabilidade legível por agente.

Skill do Claude Code

mkdir -p ~/.claude/skills/agentry
curl -fsSL https://agentry.sh/skill/agentry/SKILL.md > ~/.claude/skills/agentry/SKILL.md

O plugin em plugins/agentry empacota a mesma skill para instalações pelo marketplace de plugins do Claude Code.

Plugin Codex

O Agentry é distribuído para o Codex como uma fonte de marketplace baseada em Git. Ele não aparecerá na busca global de plugins do Codex para contas não relacionadas até que elas adicionem essa fonte de marketplace, recebam um compartilhamento de workspace ou a OpenAI a inclua.

codex plugin marketplace add fr33dr4g0n/agentry-public
codex plugin add agentry@agentry

Em seguida, abra Codex Plugins e alterne para a fonte de marketplace agentry se quiser navegar visualmente por ela.

O plugin em plugins/agentry empacota a mesma skill para instalações pelo marketplace de plugins do Codex e inclui metadados do logotipo do Agentry para os cartões de plugins do Codex.