- Keep trackers clean by cleaning out stale pull requests/issues
- Help reviewers focus by tagging WIP pull requests
- Tighten review loop by notifying when PRs need immediate attention
- Move issues between projects
CP-8 can:
- Close stale issues with no activity
- Add a
WIPlabel to PRs with "[WIP]" in title - Notify in specified Slack channel when:
- a new (non-WIP) PR is opened
- a WIP PR is "un-WIPped"
- a
:recycle:comment is posted - a PR is approved/has changes requested
- a PR is blocking other PRs signified by having
[Blocker]in the title
- Automatically add new issues to projects
- Install GitHub app
Add .cp8.yml file to root of project, and turn on features by configuring them:
stale_issue_weeks: 4 # Set stale issue cutoff to 4 weeks
review_channel: reviews # Send review requests/updates to specified Slack channel
project_column_id: 49 # Automatically add new issues to a project column
mention_threshold: 100 # Only PRs with less additions than this limit will trigger mentions (default 100)Your GitHub username needs to be mapped to your Slack ID in order for CP8 to mention you:
- Copy your Slack ID from your account settings
- In the Slack desktop application, click your name in the top left then click 'Profile & account'. On the Profile panel that opens, click the vertical ellipses button which should be below your profile photo to the right of the 'Edit Profile' button, then select 'Copy Member ID'.
- Submit a PR to this repo to add
[github_name]: [slack_id]to/lib/user_mappings.yml. See, for example, this PR)
CP8 has a CLI counterpart, that while not required, provides some extra convenience for GitHub-driven projects in addition to what the bot offers.