docs: add ClawMetry session observability tutorial - #11554
Conversation
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 57f34881a0
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| goose session | ||
| ``` | ||
|
|
||
| ClawMetry auto-detects the session store at `$XDG_DATA_HOME/goose/sessions/sessions.db`, falling back to `~/.local/share/goose/sessions/sessions.db`, which is the default on macOS and Linux. Sessions you ran before installing ClawMetry appear as well. |
There was a problem hiding this comment.
Use the platform session-store path
For default macOS installs, this is not where goose writes the sessions DB: Paths::data_dir() uses the platform app strategy, with the repo’s own env-var guide listing macOS as ~/Library/Application Support/Block/goose/, and SessionStorage then appends sessions/sessions.db. As written, macOS users following the “no configuration” flow are told ClawMetry will auto-detect ~/.local/share/..., so their existing goose sessions will not appear unless the tutorial or integration accounts for the actual macOS path.
Useful? React with 👍 / 👎.
Closes #11282.
Adds a tutorial page for observing goose sessions with ClawMetry, following the structure of the existing Langfuse and MLflow observability pages.
@jamadeo you asked whether this works without a paid plan. It does now. goose is a free runtime in the open source app, and the adapter ships in the package under MIT, so the whole path is self-hosted:
clawmetry/adapters/goose.pyFREE_RUNTIMESin the entitlement resolver listsgoosealongsideopenclawandnemoclawWhat the page covers.
pip install clawmetry, openhttp://localhost:8900, and existing goose sessions appear. There is no goose-side configuration step because ClawMetry is not in the request path: it reads$XDG_DATA_HOME/goose/sessions/sessions.dbread-only, honouring XDG the same way goose does.On accuracy. The page claims only what the adapter actually surfaces, which is sessions, transcripts, models, and token totals. It states plainly that goose records a cost figure only for providers that report one, so with a local provider such as Ollama the tokens are real and the cost is left empty rather than estimated. No live-stream or agent-control claims, since the goose adapter does not declare those capabilities.
Notes for review.
autogenerated, so nosidebars.tschange is needed.I am the ClawMetry maintainer. Glad to adjust tone, length, or structure to whatever you prefer.