haven-orb
GitHub用于读取 Haven Orb 工具收集的用户反馈、页面控制台日志及网络请求数据,辅助前端开发人员进行 UI 调试和问题排查。
Trigger Scenarios
Install
npx skills add langwatch/langwatch --skill haven-orb -g -y
SKILL.md
Frontmatter
{
"name": "haven-orb",
"description": "Read what a person sent from the haven orb on the app page: `haven orb feedback` notes with selector, viewport, console and requests, and `haven orb console|network`. Use when someone says 'haven feedback', 'haven page console', 'haven orb feedback', 'the haven orb', 'read the notes I left', 'resolve the feedback', 'wait for feedback', 'page console errors', 'failed requests on the page', 'haven orb', or 'what did I point at'.",
"argument-hint": "feedback list --open | show <id> | resolve <id> | wait | console|network",
"user-invocable": true
}
The haven orb: feedback and page buffers
When haven runs a stack, dev or built UI, the app page carries the haven orb, bottom right
(apps/ui/vite/haven-orb/, specs/setup/haven-dev-orb.feature). A reader picks an element or
drags a region, types a note, and it lands in this stack's store. The orb also pushes the page's
last 200 console messages and requests: method, URL without its query, status, duration. Never a
body, a header or a cookie.
While building UI, read it before you call the work done:
haven orb feedback list --open --agent # notes nobody resolved yet
haven orb feedback show <id> --agent # one note: selector or region, viewport, console, requests
haven orb feedback resolve <id> # once you fixed it
haven orb feedback wait --timeout 5m # block until the reader sends the next note (default 30s)
haven orb console --level error --agent # levels: error, warn, info, log, debug
haven orb network --failed --agent
--jsonand--stack <slug>work on all of them.- The page buffer is whichever tab pushed last, and is empty until someone opens the app with the
orb showing. The files live in
.haven/logs/<slug>/orb/. - On a built-UI stack (
haven upor--watch) the dev runtime injects the orb into the built page (tools/dev-runtime/src/haven-orb.ts); the first page load waits a few seconds while it builds. Under--hmrthe Vite lane injects the same orb itself (apps/ui/vite.config.ts). Without a person's tab, drive the page withhaven-browser.
Version History
- c0c14dc Current 2026-10-19 19:33


