| config | Path to the revuiw config file, passed as `--config`. Omit to use ./revuiw.config.ts. | no | "" |
| working-directory | Directory containing the application repository checkout. | no | . |
| agent | Agent binary family to resolve when `agent-executable` is not provided: `claude` or `codex`. This only resolves/installs the binary — the revuiw config selects what actually runs (`agents.reviewer.adapter: "codex"` for a Codex review). | no | claude |
| agent-executable | Path or name of a user-provided agent binary (for example Claude Code from a Nix devShell). When set, the action installs nothing and exports it as REVUIW_AGENT_EXECUTABLE. | no | "" |
| browser-executable | Path to a Chromium/Chrome binary to review with (for example `pkgs.chromium` from a Nix devShell), exported as REVUIW_BROWSER_EXECUTABLE. When set, Playwright launches it directly — no browser download, no host-requirements ldd check — and the `install-browser-deps` apt step is skipped automatically. | no | "" |
| claude-code-version | @anthropic-ai/claude-code version installed when no agent binary is provided or found on PATH. | no | 2.1.206 |
| codex-version | @openai/codex version installed when `agent: codex` and no agent binary is provided or found on PATH. | no | 0.144.1 |
| revuiw-version | @lunarhue/revuiw version executed via `pnpm dlx`. | no | latest |
| setup-node | Install Node.js 22 and enable corepack/pnpm. Disable when your job already provides them (for example via Nix). | no | true |
| install-browser-deps | Install Chromium system libraries with `npx playwright install-deps chromium` so the review browser can launch. | no | true |
| cache | Cache the Playwright browser download (~/.cache/ms-playwright) and the pnpm store/dlx cache across runs, keyed on `playwright-mcp-package`, so Chromium is not re-downloaded on every review. | no | true |
| playwright-mcp-package | @playwright/mcp package spec used for the review browser (exported as REVUIW_PLAYWRIGHT_MCP_PACKAGE and used as the browser cache key). Pin an exact version; defaults to the version pinned by revuiw itself. | no | @playwright/mcp@0.0.45 |
| upload-evidence | Upload the `.revuiw/` directory (report.html, screenshots, logs) as a workflow artifact. | no | true |
| evidence-retention-days | Retention for the evidence artifact. | no | 30 |
| comment | Create or update the sticky pull request comment. | no | true |
| apply | Gate the job on the recorded infrastructure result (0 ran, 1 failed, 2 blocked). Disable to inspect the `exit-code` output yourself. | no | true |
| github-token | Token used to publish the pull request comment. | no | ${{ github.token }} |
| base-sha | Base commit of the reviewed pull request. Defaults to the pull_request event's base. | no | "" |
| head-sha | Head commit of the reviewed pull request. Defaults to the pull_request event's head. | no | "" |
| pr-number | Pull request number for the sticky comment. Defaults to the pull_request event's number. | no | "" |
| full-review | Ignore the previous review's embedded state and review the full pull request diff from scratch, as if the pull request had never been reviewed. The completed run's state replaces the old baseline as usual (a crashed run leaves it in place). | no | false |