jorgealegre/Narrative Review

AI-powered narrative code review for pull requests

Trust Signals

name	description	required	default
anthropic-api-key	Anthropic API key for Claude	yes	—
github-token	GitHub token with checks and contents write permissions	no	${{ github.token }}
model	Claude model to use (claude-haiku-4-5-20251001, claude-sonnet-4-6, claude-opus-4-6)	no	claude-sonnet-4-6
max-diff-size	Maximum diff size in bytes before skipping analysis	no	512000
max-lines	Maximum lines changed (additions + deletions) before skipping	no	5000
max-cost	Maximum estimated cost in USD before skipping	no	2.00
force	Set to 'true' to bypass all size/cost/line checks	no	false
allow-public-pages-on-private-repo	SECURITY: GitHub Pages sites can be publicly readable on Free/Pro/Team plans even when the source repo is private — so the review (diff + file contents + analysis) would be world-readable at a stable URL. The action handles this automatically: on a private repo it probes the Pages config and proceeds with deploy when access control is on (Enterprise Cloud, `public: false`), and skips the deploy + uploads an artifact instead when Pages is publicly readable. Only set this to `true` if you want to override the safe default and deploy regardless (e.g. you accept the public exposure, or Pages isn't configured yet but you trust the org defaults). Ignored on public repos.	no	false

name	description
review-url	URL to the generated narrative review page
chapters	Number of chapters in the generated review