superbuilders/repo-port-bot

Automatically port merged changes to a paired repository.

Trust Signals

name	description	required	default
github-token	Fallback GitHub API token used for source reads and target writes.	no	—
source-github-token	Optional GitHub API token for source repository reads.	no	—
target-github-token	Optional GitHub API token for target repository writes.	no	—
llm-api-key	Anthropic API key used by the Claude agent provider.	yes	—
target-repo	Target repository in owner/name format.	yes	—
target-default-branch	Default branch for the target repository checkout and PR base.	no	main
validation-commands	Newline-separated validation commands to run in target repo.	no	""
path-mappings	JSON object mapping source paths to target paths.	no	{}
naming-conventions	Optional naming convention guidance for the agent prompt.	no	""
prompt	Additional custom prompt instructions.	no	""
skip-port-bot-json	Skip fetching port-bot.json from source repo at merge SHA.	no	false
include-cost-telemetry	Render cost and token telemetry in PR/comment bodies and the Actions summary.	no	true
model	Claude model to use.	no	claude-sonnet-4-6
max-attempts	Maximum number of execution attempts before stalling.	no	3
max-turns-execution	Maximum Claude SDK turns per execution attempt.	no	250
max-turns-decision	Maximum Claude SDK turns for the decision/classification phase.	no	50
max-budget-usd	Optional budget cap (USD) for a single attempt.	no	""
log-level	Minimum log level for stdout output (error, warn, info, debug).	no	info
commit-sha	Override the merge commit SHA to process (defaults to GITHUB_SHA from the workflow event).	no	""

name	description
run-id	Unique identifier for this port run.
outcome	Final run outcome from the engine.
pr-url	URL of created target pull request, if any.
issue-url	URL of created follow-up issue, if any.
summary	Human-readable run summary.