Skip to content
PullFlow Docs

Commands and AI Agent Actions

PullFlow enables you to manage pull requests directly within Slack. You can use structured commands or ask the PullFlow AI agent to perform quick actions on pull requests.

natural-language.png

Using structured commands

You can tag the PullFlow agent in PR threads to execute specific actions. Below is a list of supported commands:

Example command

@Pullflow request review from @John

Available commands

  • @Pullflow request review [from] @Jane Request a code review from a specific team member.
  • @Pullflow assign [to] @Janet Assign a pull request to a team member.
  • @Pullflow add labels wip, documentation Add labels to the pull request.
  • @Pullflow add review comment "message" Add a comment to the review.
  • @Pullflow request changes "message" Request changes on the pull request with an optional message.
  • @Pullflow remove labels wip, documentation Remove labels from the pull request.
  • @Pullflow approve "message" Approve the pull request with an optional message.
  • @Pullflow close Close the pull request.
  • @Pullflow reopen Reopen a closed pull request.

Note: Terms in [square brackets] are optional.

AI Agent PR actions

You can interact with PullFlow AI using conversational language in Slack threads to perform quick PR actions.

For example:

@Pullflow how do I do this in JS?
@Pullflow LGTM

This feature eliminates the need to memorize command syntax, allowing you to manage PRs seamlessly within Slack threads.

Note: PullFlow Enterprise users can opt out of Generative AI features which would disable conversational assistance. The commands syntax will still work.

Additional examples

  • “@Pullflow request a review from @John”
  • “@Pullflow approve this PR”
  • “@Pullflow assign this to @Janet”
  • “@Pullflow request changes: fix the linting errors”
  • “@Pullflow add labels wip, documentation”

Slash commands in Slack

In addition to thread-specific commands, PullFlow provides Slash commands to configure and manage integrations directly in Slack channels.

Available Slash commands

Add the PullFlow bot to a channel

To invite the PullFlow bot to a specific Slack channel:

/invite @Pullflow

Update repo-to-channel configuration

To configure or update repositories linked to a Slack channel:

/pullflow config

Get help

To view a list of available commands and their usage:

/pullflow help

Example workflow

  1. A user creates a pull request on GitHub.

  2. In the connected Slack channel, the user mentions the PullFlow bot to request a review:

    @Pullflow request review from @Jane

  3. Alternatively, the user can use natural language:

    @Pullflow Can you assign this PR to Jane for review?

  4. PullFlow processes the command or natural language input and updates the PR status in GitHub.

Additional Resources