Improve Convex Plugin

Send THIS Codex session's transcript to the Convex quickstart backend for an AI post-mortem that improves the whole system (runbook, bootstrap, skills). TRIGGER when the user runs $improve-convex-plugin, or after a quickstart build says 'send feedback', 'report how that went', or 'help improve the quickstart'.

get-convex 7ddbc40 1.6 KB Updated

File contents

Send session for review ($improve-convex-plugin)

Ships the current Codex session transcript to anteater's /review endpoint, which runs an AI post-mortem and returns concrete findings to improve the runbook / bootstrap / skills. The user's text after $improve-convex-plugin is an optional note about how the run went (pass it as --idea).

Run it (QB_HARNESS=codex tells the helper to read the Codex transcript):

curl -fsSL "https://basic-anteater-667.convex.site/send-transcript" \
  | QB_HARNESS=codex bash -s -- --idea "<the user's note, or the app idea>"

Read the output:

  • REVIEW_DONE status=done → summarize for the user: overall outcome + summary, then the top findings by severity (each: titletargetsuggestedFix), then the wins. Keep it about the system, never paste back secrets (the helper already redacts).
  • REVIEW_PENDING → it was submitted; the review is still running. Tell the user it's queued (the printed /review/<id> can be re-checked).
  • REVIEW_NO_TRANSCRIPT / REVIEW_TRANSCRIPT_TOO_SMALL → no Codex transcript found; tell the user.
  • REVIEW_UPLOAD_FAILED → the endpoint was unreachable (network/sandbox) — report it.

get-convex/convex-codex-plugin/tree/main/plugins/convex/skills/improve-convex-plugin commit 7ddbc407d2

Frequently asked questions

npx skillmds@latest add get-convex/improve-convex-plugin