agenteye CLI 与您的仪表板通信，是一个独立工具，与负责将事件发送到服务器的采集器不同。
您的整个部署，一条命令即可搞定
不必再为一个简单问题而反复切换标签页。agenteye CLI 通过单一二进制文件读取您的数据并管理您的组织，原本需要在仪表板中点来点去才能完成的检查，现在只需一行命令即可复用、设置别名或粘贴到操作手册中。它提供四个操作入口：
- 读取数据：
sessions、events、evals和errors，支持按时间、智能体和环境过滤。 - 管理组织：
keys、users、settings、alerts和incidents。 - 运行分析： 支持保存的 SQL 查询，以及针对事件数据的即席
query执行。 - 询问助手：
agent ask可访问与仪表板中相同的只读分析助手。
pipx 一次性安装，通过邮件发送的 6 位验证码登录，即可开始使用。会话有效期约为一天，过期后重新运行 agenteye login 即可。无需打开浏览器，直接用它检查生产环境、创建密钥或快速处理正在触发的事件：
--json 等全局选项必须放在命令之前。agenteye --json sessions 是正确的，agenteye sessions --json 则不行。
编写脚本，集成到 CI
每条命令都支持--json，这带来了质的变化。干净的 JSON 输出到 stdout，而人类可读的状态信息和警告则输出到 stderr，因此使用 --json 捕获的内容可以直接通过管道传给 jq，无需过滤多余的行。这也是 CLI 既适合您在终端直接使用，也适合编程智能体解析输出的原因：
0 表示成功，4 表示未登录，5 表示缺少权限（消息中会指明具体权限，例如 alerts:write），3 表示仪表板无法访问。脚本可以根据 4 进行重新认证，或根据 5 精确告知需要向管理员申请哪些权限，而不是盲目失败。
用自然语言让编程智能体来驱动
更好的是，您根本不需要记住这些参数。CLI 技能是一个名为agenteye-cli 的小型 Agent Skill 文件夹，它可以教会 Claude Code 或 Codex 等编程智能体通过自然语言来驱动 CLI。只需问”今天有什么问题吗？“，智能体就会选择合适的命令，以您的身份执行，并以文字形式给出答复。
对于 Claude Code，将 agenteye-cli 文件夹放入 ~/.claude/skills/ 即可自动发现。Failproof AI 可观测性提供该文件夹；无需额外安装任何内容，因为它只是驱动您已经安装的 CLI。请先自行登录：技能无法替您完成邮件验证码登录流程。
由于智能体以您的身份运行 CLI，它可以执行您的登录权限所允许的一切操作，包括读写：创建密钥、修改设置、解决事件。CLI 的”您确定吗？“提示对智能体不会触发，因此技能的设计是：在执行任何变更操作前，先明确说明将要执行的命令，并等待您确认。您就是那个确认步骤。
相关链接
- CLI 参考文档：所有命令、参数和 JSON 格式说明。
- 面向智能体的 CLI 使用示例：可直接复制的
jq模式和退出码处理方法。 - CLI 智能体技能：安装和运行
agenteye-cli技能。 - AI 助手：仪表板内置分析助手，也是
agent ask的访问目标。