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'.

Jump to install

Repository: get-convex/convex-codex-plugin
Last source activity: July 16, 2026 at 23:06
Detected SKILL.md language: English
Stars: 5
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/get-convex/convex-codex-plugin --skill improve-convex-plugin

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

name	improve-convex-plugin
description	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'.
license	Apache-2.0

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: title → target → suggestedFix), 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.

Back to search Back to installation

convex-expert

Convex backend rules — consult this whenever writing or editing any code inside a convex/ directory (schemas, queries, mutations, actions, HTTP endpoints, crons, file storage, auth, component installation). TRIGGER before touching convex/ functions, so the code uses the object-form syntax, validators, indexes, and component patterns that generic models get wrong.

2026-08-28

labs-quickstart

LABS — the FULL Convex quickstart experience: scaffold a running Next.js + shadcn app from one sentence with passkey (WebAuthn) sign-in and a live in-app Chef feedback panel pre-baked, build the idea live, then PUBLISH it to a public https://<app>.convex.app URL (with the user's confirmation before publishing). TRIGGER when the user runs $labs-quickstart, or asks for the full/labs quickstart, a published/public app, sign-in/passkeys, or the in-app feedback panel from scratch. For a plain local-only scaffold use $quickstart instead. SKIP when there's already a Convex project in the cwd.

2026-08-28

quickstart

Scaffold a running Next.js + shadcn Convex app from one sentence — convex dev + next dev already running — then build the idea live (runs locally). TRIGGER when the user wants to START a new Convex app from scratch — e.g. they ran $quickstart, said 'scaffold a new app', 'build me an app where users can ___', or 'new app'. SKIP when there's already a Convex project in the cwd.

2026-08-28

View all from this repository

name	improve-convex-plugin
description	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'.
license	Apache-2.0

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

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: title → target → suggestedFix), 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.

improve-convex-plugin

Source facts

Install options

Review the source files

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

More from this repository

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

More from this repository