| task | caretta subcommand to run (for example: housekeeping, backlog-curation, ideation, sprint-planning, code-review, fix-conflicts, issue, loop, tracker-matrix). | yes | — |
| args | Positional arguments for tasks that need them (e.g. PR number for fix-pr/fix-conflicts, issue number for issue, tracker number for loop/tracker-matrix, plus optional flags such as `--json` for tracker-matrix). | no | "" |
| agent | Which agent CLI to drive (claude, cline, codex, copilot, gemini, junie, xai, cursor). All adapters except cursor are bundled inside the caretta release binary; cursor must already be on PATH. | no | claude |
| version | caretta release tag to install. Use 'latest' to resolve the most recent release. | no | latest |
| auto | Pass --auto to caretta. Reduces adapter permission prompts and, for two-phase workflows (ideation, housekeeping, sprint-planning, retrospective, etc.), synthesizes stand-in feedback so the draft chains straight into finalize. Defaults to true because Actions runs are non-interactive. | no | true |
| dry-run | Pass --dry-run to caretta (print intended actions without executing). | no | false |
| preset | Workflow preset to use (overrides workflow_preset in caretta.toml). Empty = use the project's configured preset. | no | "" |
| working-directory | Directory to run caretta in. Defaults to the repository root checked out by actions/checkout. | no | "" |
| configure-git | Configure git user.name/user.email as github-actions[bot] before running. Disable if you handle git identity yourself. | no | true |
| github-token | Token exposed to caretta as GH_TOKEN for gh CLI calls. Defaults to the workflow's GITHUB_TOKEN. | no | ${{ github.token }} |