自托管 AI Coding Agent 注册中心，内置可观测性遥测管线与 LLM 驱动的评估引擎，支持零侵入 MCP Server 调用链追踪。
Observal 是一个自托管的 AI Coding Agent 注册中心，定位为"AI Agent 界的 Docker Hub"。其核心由三大能力构成：
Agent Registry：以可移植 YAML 格式打包完整 Agent 配置（含 MCP servers、skills、hooks、prompts、sandboxes），支持一条命令安装到 Claude Code、Kiro CLI、Cursor、Gemini CLI 等主流 IDE，实现 Agent 的发现、分享与复用。
Telemetry Pipeline：通过透明 shim 层拦截 IDE 与 MCP Server 之间的通信，将每个 tool call 转化为 span，进而组成 trace 和 session。数据经 OpenTelemetry Collector 写入 ClickHouse，对被观测的 MCP Server 做到零侵入、零代码修改。支持 Claude Code 和 Kiro 的原生 OTLP 导出双通道。
Evaluation Engine：基于 AWS Bedrock 或 OpenAI-compatible LLM 对 Agent session 自动打分，评估维度涵盖 goal completion、tool efficiency、factual grounding、thought process 和 adversarial robustness，支持跨版本对比。
IDE 兼容性：Claude Code（Full）、Kiro CLI（Full）、Gemini CLI、Codex CLI（原生 OTEL + shim）、GitHub Copilot、OpenCode、Cursor（MCP + shim）。
架构概览：采用 8 服务 Docker Compose 编排——Next.js 16 前端（React 19 + Tailwind CSS 4 + shadcn/ui）、FastAPI + Strawberry GraphQL 后端（Python 3.11+）、PostgreSQL 16（Registry 元数据）、ClickHouse（遥测数据）、Redis + arq（异步任务）、OpenTelemetry Collector、Grafana（内置仪表板）、Nginx 反向代理。全部组件自托管，无数据外泄风险。CLI 提供独立二进制分发，支持 scan、doctor patch、pull 等工作流命令。
私有分支功能：observal-insight-god 分支包含 Session Reconciliation（解析 Claude Code JSONL 文件上传完整会话数据）和 Agent Insights V2（多模型 LLM 报告生成：Opus 叙述、Sonnet 综合、Haiku facet 提取，含 Subagent 父子会话归属追踪），尚未合入 main。
企业版：仓库 ee/ 目录包含 SSO、SCIM 和审计日志能力，发布状态待确认。开源协议为 Apache License 2.0，当前版本 v0.3.4。