Skip to content

Commands

Publishes a migration bundle release from a merged template PR.

Terminal window
publish-template-migration 123

Environment:

NameRequiredDescription
GITHUB_REPOSITORYYesTemplate repository in OWNER/REPO form.
GITHUB_TOKENYesToken with release write access and PR read access.
TEMPLATE_SYNC_GENERATE_SUMMARYNoSet to true, 1, yes, or on to generate one reusable migration summary during publishing.
OPENAI_API_KEYYes when TEMPLATE_SYNC_GENERATE_SUMMARY is enabledAPI key for summary generation.
OPENAI_MODELNoSummary model. Defaults to gpt-5.5.
TEMPLATE_SYNC_SUMMARY_MOCK_RESPONSENoJSON summary response used for local or test runs instead of OpenAI.

Discovers the newest migration and opens a draft PR in a subscriber repository.

Terminal window
subscriber-template-sync

Environment:

NameRequiredDescription
GITHUB_REPOSITORYYesSubscriber repository in OWNER/REPO form.
TEMPLATE_SYNC_BOT_TOKENYesBot token for subscriber repository writes.
TEMPLATE_SYNC_DEFAULT_UPSTREAM_REPOYesDefault template repository in OWNER/REPO form.
TEMPLATE_SYNC_UPSTREAM_READ_TOKENNoRead token for private upstream releases.

Handles /template-sync comments on migration PRs.

Terminal window
handle-template-sync-command

Environment:

NameRequiredDescription
GITHUB_REPOSITORYYesSubscriber repository in OWNER/REPO form.
GITHUB_EVENT_PATHYesGitHub event payload path.
TEMPLATE_SYNC_BOT_TOKENYesBot token for checkout, push, comments, and variables.
TEMPLATE_SYNC_DEFAULT_UPSTREAM_REPOYesDefault template repository.
OPENAI_API_KEYYes for approve/reviseAPI key for generation.
OPENAI_MODELNoGeneration model. Defaults to gpt-5.5.
TEMPLATE_SYNC_GENERATION_MOCK_RESPONSENoJSON plan used for local or test runs instead of OpenAI. OPENAI_API_KEY is still required for approve/revise so missing production configuration fails clearly.