Run from GitHub

Start an organization workflow from an issue or pull-request conversation.

Prepare organization automation

An owner or admin installs the GitHub App and grants the repository. Save a compatible Org profile and its provider connections. These runs use the organization's resources and assigned repository environment, without borrowing anyone's personal connections.

The commenter needs current Write, Maintain, or Admin repository access. Organization membership alone is insufficient.

Post a command

Issue: use the Org default
@zeroshot-app run
Review: use a configured Org review profile
@zeroshot-app run review

The first form selects the Org default profile; the second selects the exact Org profile named review. Put one command on its own line in a new comment. Matching is case-sensitive. Flags and scope prefixes such as org:review are invalid. Edits, inline review comments, quoted commands, and code blocks do not start runs.

Choose implementation or review

Implementation profiles accept task and optional issueNumber input and run from issues. On pull requests, use a PR review profile; use Issue review for issue discussions. Review profiles use URL/context input and publish a final comment. PR review captures its base/head revisions before execution.

Follow the result

Zeroshot reacts to the command and posts a run link with lifecycle updates. Open it for progress and confirmed delivery. Webhook retries return the original run; a new matching comment starts another run.

If no run starts, check the exact command, commenter permissions, App repository access, and the Org profile's inputs and connections. If a link appears, use Runs for admission or execution errors.