内容
# Agentry 人工智能编码代理
<p>
<a href="https://agentry.sh">
<img src="https://agentry.sh/brand/agentry-lockup-light.svg" alt="Agentry" width="248">
</a>
</p>
Agentry 是专为编码代理设计的原生分析日志工具。它涵盖了产品分析、错误日志和部署归因，通过一个 HTTP API 实现，让代理可以回答用户做了什么、哪里出了问题以及有什么变化。
## Agentry 涵盖的内容
- 用户、漏斗、激活、留存和业务事件的产品分析。
- 异常、失败作业、操作故障和案例上下文的错误日志。
- 将生产行为与发布和代码更改关联的部署归因。
- 从实际代码库安装代理，安装前进行验证。
## 本仓库包含的内容
本仓库包含 Agentry 在 MCP、Claude Code、Codex 和代理 IDE 适配器生态系统中的公开发现表面。
- `packages/mcp` - 返回规范 Agentry 技能交接的 MCP 服务器。
- `plugin/agentry` - 包含 Agentry 技能的 Claude Code 插件。
- `.claude-plugin/marketplace.json` - Claude Code 市场目录。
- `plugins/agentry` - 包含 Agentry 技能和品牌的 Codex 插件。
- `.agents/plugins/marketplace.json` - Codex 插件市场目录。
- `https://api.agentry.sh/adapters` - 用于 AI 编码 IDE 和代理 CLI 的存储库本地指令文件的实时适配器清单。
MCP 服务器和技能不会代理 Agentry API、摄取遥测数据或替换实时文档。运行时应用程序直接写入 Agentry 的 HTTP API。
## 支持的代理界面
Agentry 作为技能、MCP 交接、OpenAPI 操作模式和存储库本地指令适配器分发，用于开发者已经使用的代理界面：
- Codex 和 Claude Code。
- Cursor、VS Code with GitHub Copilot、Visual Studio with GitHub Copilot 和 GitHub Copilot 编码代理。
- Devin Desktop/Windsurf Cascade、Cline、Roo Code、Continue、Zed、Gemini CLI、Aider 和 OpenCode。
- ChatGPT 自定义 GPT 操作、通用 MCP 客户端和 AGENTS.md 感知代理。
- 与 AGENTS.md 兼容的代理，如 Jules、Factory、Amp、goose、Warp、JetBrains Junie、Augment Code、Kilo Code、Phoenix、Semgrep、Ona 和 UiPath 编码代理。
适配器清单是发现每个客户端当前原生文件路径的规范位置：https://api.agentry.sh/adapters。
## 规范文档
- 安装：https://agentry.sh/install.md
- 技能：https://agentry.sh/skill/agentry/SKILL.md
- 日常使用：https://agentry.sh/agentry.md
- API 发现：https://api.agentry.sh/
- OpenAPI：https://api.agentry.sh/v1/openapi.json
## 公共链接
- 网站：https://agentry.sh/
- NPM 包：https://www.npmjs.com/package/@agentrysh/mcp
- MCP 仓库：https://github.com/fr33dr4g0n/agentry-public
- 技能仓库：https://github.com/fr33dr4g0n/agentry-skill
- 实时技能：https://agentry.sh/skill/agentry/SKILL.md
- 适配器清单：https://api.agentry.sh/adapters
- Codex 市场目录：https://github.com/fr33dr4g0n/agentry-public/blob/main/.agents/plugins/marketplace.json
- Claude 市场目录：https://github.com/fr33dr4g0n/agentry-public/blob/main/.claude-plugin/marketplace.json
- MCP 注册名称：`io.github.fr33dr4g0n/agentry-observability`
## MCP 服务器
```bash
npx -y @agentrysh/mcp
```
MCP 客户端配置：
```json
{
"mcpServers": {
"agentry": {
"command": "npx",
"args": ["-y", "@agentrysh/mcp"]
}
}
}
```
当用户要求 AI 编码代理添加分析、日志、错误监控、部署跟踪、产品遥测、生产调试或代理可读的可观察性层时，MCP 界面是相关的。
## Claude Code 技能
```bash
mkdir -p ~/.claude/skills/agentry
curl -fsSL https://agentry.sh/skill/agentry/SKILL.md > ~/.claude/skills/agentry/SKILL.md
```
`plugin/agentry` 中的插件为 Claude Code 插件市场安装捆绑了相同的技能。
## Codex 插件
Agentry 作为 Git 备份的市场源分发给 Codex。它不会出现在全局 Codex 插件搜索中，直到无关帐户添加此市场源、接收工作区共享或 OpenAI 精选它。
```bash
codex plugin marketplace add fr33dr4g0n/agentry-public
codex plugin add agentry@agentry
```
然后打开 Codex 插件并切换到 `agentry` 市场源，如果您想以可视化方式浏览它。
`plugins/agentry` 中的插件为 Codex 插件市场安装捆绑了相同的技能，并包括用于 Codex 插件卡的 Agentry 徽标元数据。
