Practical Notes
- GitHub: 341 stars · 16 forks; pushed 2026-04-14 (verified via GitHub API).
- README provides a live demo and a Storybook site for component exploration.
- README suggests using
TraceViewerplus an OpenTelemetry span adapter to convert raw trace docs into UI spans.
Main
A trace debugging workflow that scales:
- Add a trace ID to every user request, and propagate it through tools and agent retries.
- Normalize spans so your UI always shows: plan → tool call → model call → result.
- Annotate spans with costs (tokens/latency) so “slow” and “expensive” paths are obvious.
- Keep a “known good” trace for each feature—use it as a regression fixture when prompts change.
The payoff is faster iteration: you can fix a broken agent by looking at one timeline instead of many logs.
FAQ
Q: Is it production-ready? A: README marks it as an alpha release; expect API changes and pin versions when adopting.
Q: Do I need OpenTelemetry? A: No, but README shows adapters for OpenTelemetry spans; any trace format can be converted.
Q: What is the simplest component to start with?
A: README suggests TraceViewer, which provides a complete trace UI surface.