Skip to content

feat(cli): report a bad render, and open support from the terminal - #8

Open
AJCJ1 wants to merge 1 commit into
mainfrom
feat/render-report
Open

AJCJ1 wants to merge 1 commit into
mainfrom
feat/render-report

Conversation

@AJCJ1

@AJCJ1 AJCJ1 commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Adds a way to report a bad render straight from the CLI, plus a shortcut to the support page (as a precursor to reporting an issue with the CLI itself).

urlbox report <renderId> files a render report with the Urlbox team (a category and a short comment).

  • Agents and scripts pass --category and --comment and get no prompts.
  • In an interactive terminal without those flags, it prompts: a category picker, then a one-line description.
  • JSON output returns the full report and quiet output returns the report id only

A post-render hint. After a render, the CLI prints one muted line naming the render id and the ready-to-run report command:

✓ Rendered: https://renders.urlbox.com/…png
  Something wrong with this render? Report it: urlbox report 01a0…_ps

It only appears in a real terminal in text mode. Piped, JSON, and quiet output aren't changed.

urlbox support opens the contact page in the browser (prints the URL instead when there's no browser, and never launches one in JSON/quiet mode) — the same shape as urlbox dashboard.

Notes

  • The render id for the hint comes from the API's response header (and the error body on failures); it's held in memory only, so no response shape changes. - this avoids requiring an API change
  • Reports are limited to a category and a comment for now — no region/area highlighting.

Adds `urlbox report <renderId>` to file a render report with the Urlbox
team (category + comment), a post-render hint that prints the ready-to-run
report command, and `urlbox support` to open the contact page.

- Every render response prints a muted hint line naming the render id and
  the report command, text-mode + TTY only (json/quiet/piped unchanged).
- `urlbox report` is session-authed (needs `urlbox login`): --category and
  --comment for scripts and agents, an interactive picker + comment prompt
  otherwise. Errors map to the closed exit-code set (auth 3, not-found 5,
  conflict 7).
- The api client captures the render id from the x-urlbox-request-id
  response header and error-body requestId, in-memory only so envelopes
  are byte-identical.
- `urlbox support` mirrors `urlbox dashboard`: opens the contact page,
  prints the URL when headless, never launches a browser in json/quiet.
- Also scrubs review-round shorthand and private-repo references out of
  existing comments.
@AJCJ1
AJCJ1 marked this pull request as ready for review September 16, 2026 10:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant