ai-outfitter/Run Outfitter Profile

Run an Outfitter profile headless in GitHub Actions to build scheduled commit reviewers, PR reviewers, or task agents.

View on GitHub

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Jul 11, 2026
License: MIT

Pinned Snippet

workflow.ymlSHA-pinned

uses: ai-outfitter/actions@f73a8f19fe2c2d4c81db85760cad7f4747672814 # v1.0.0

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
prompt	The prompt passed to the agent in print mode. The agent runs headless, does its work, prints its result, and exits.	yes	—
profile	Outfitter profile id to run (passed as `outfitter run --profile`).	yes	—
profile-source	Optional profile catalog to make the profile available. Accepts an `owner/repo` GitHub shorthand, any git-cloneable URI, or a path inside the checked-out repository (e.g. `.outfitter/profiles`).	no	""
profile-source-ref	Optional tag, branch, or commit to pin a remote profile-source to. Strongly recommended for catalogs you do not own — an unpinned source runs whatever the catalog publishes next.	no	""
agent	Agent adapter to launch: pi or claude.	no	pi
github-token	Token exported as GH_TOKEN / GITHUB_TOKEN for the agent's `gh` and `git` calls. Defaults to the workflow's installation token; pass a fine-grained PAT from a dedicated machine account to have the agent comment, push, or open PRs under that account. See docs/token-permissions.md and docs/bot-account.md before widening this.	no	${{ github.token }}
git-user-name	Git author/committer name for any commits the agent makes.	no	""
git-user-email	Git author/committer email for any commits the agent makes.	no	""
outfitter-version	@ai-outfitter/outfitter version to install.	no	latest
strict	Fail instead of warning when profile controls cannot be translated by the adapter.	no	false
working-directory	Directory the agent runs in.	no	.
transcript-artifact	Name of the workflow artifact to save the agent's full session transcript to, as a self-contained HTML page (pi's native session export). Set to an empty string to disable. Currently pi-only; ignored for other agents. The artifact link is exposed as the `transcript-artifact-url` output so workflows can post it back to the issue or PR the agent worked on.	no	outfitter-transcript

Outputs

name	description
transcript-artifact-url	URL of the uploaded transcript artifact, or empty when transcript saving is disabled, unsupported for the agent, or no session was written. Viewing requires being logged in to GitHub with access to the repository.