| backlog-task-id | Backlog.md task ID to load and solve, for example 7, task-7, or BACK-7. | yes | — |
| github-token | GitHub token used to push the branch and create the pull request. Use a token with workflow-file write permission when commits can touch .github/workflows. | no | — |
| config-dir | Directory in the checked out repository containing prompts and hook scripts. | no | ./backlog-to-pr |
| provider | Coding CLI provider adapter to run. Supported values are codex and opencode. | no | codex |
| base-branch | Pull request base branch. Defaults to the checked out branch. | no | — |
| branch-prefix | Prefix for generated solution branches. | no | backlog-to-pr |
| commit-message | Commit message. Supports {ticket} and {summary}. | no | Solve {ticket} |
| pr-title | Pull request title. Supports {ticket} and {summary}. Default follows Conventional Commits (`feat: {summary}`); override with a user-supplied template to use a different format. | no | feat: {summary} |
| pr-body | Optional pull request body. Supports {ticket} and {summary}. | no | — |
| pr-labels | Comma-separated labels to add to the pull request. | no | — |
| draft | Create the pull request as a draft. | no | false |
| backlog-install-command | Command used to install Backlog.md when neither npx --no-install --package backlog.md backlog nor a backlog binary is available. The action resolves backlog.md through npx --package backlog.md, using the version declared in the checked out repository's package.json (installing it globally on demand when not already present). | no | npm install -g backlog.md |
| codex-install-command | Command used to install Codex CLI when the codex provider runs. | no | npm install -g @openai/codex |
| codex-model | Optional model name passed to Codex CLI. | no | — |
| codex-args | Extra arguments passed to codex exec. | no | — |
| opencode-install-command | Command used to install OpenCode CLI when the opencode provider runs. | no | npm install -g opencode-ai |
| opencode-model | Optional model name passed to OpenCode CLI, in provider/model form. | no | — |
| opencode-agent | Optional OpenCode agent name. | no | — |
| opencode-go-subscription-key | Optional OpenCode Go subscription API key. When set, the opencode provider receives it through OPENCODE_AUTH_CONTENT. | no | — |
| opencode-args | Extra arguments passed to opencode run. | no | — |
| tag-trigger | When true, @mention the actor who triggered the workflow in the PR body. | no | false |
| fail-on-empty-diff | Fail when the provider leaves no repository changes. | no | true |