Configuration

Accessing Configuration

All configuration happens in the Slack Home Tab:

1. In Slack, search for @Nudgy Bot
2. Click on the bot name
3. Click the Home tab at the top
4. You'll see all your organizations and repositories organized beautifully

Repository Mapping

Map GitHub repositories to Slack channels to control where notifications are sent.

Add a Repository

1. In the Home Tab, find your GitHub organization
2. Click "Add Repository from [Org Name]"
3. Select a repository from the dropdown (shows only authorized repos)
4. Choose which Slack channel receives notifications
5. Click "Add Repository"

Edit a Repository

1. Find the repository in your Home Tab
2. Click the "Edit" button
3. Update channel, reminder timing, or weekly stats settings
4. Click "Save"

Remove a Repository

1. Click "Edit" on the repository
2. Scroll to the bottom of the modal
3. Click "Remove Repository"
4. Confirm the removal

Reminder Configuration

Each repository has its own reminder schedule. Configure when and how often the bot sends PR reminders.

Default Schedule

By default, reminders are sent at these times after PR opens:

• 1st Reminder: 1 hour after PR opens
• 2nd Reminder: 4 hours after PR opens
• 3rd Reminder: 10 hours after PR opens
• 4th Reminder: 34 hours after PR opens
• 5th+ Reminders: Every 24 hours after that

Custom Timing

To customize reminder timing for a specific repository:

1. Click "Edit" on the repository in the Home Tab
2. Scroll to the "Reminder Timing" section
3. Enter absolute hours from PR creation for each reminder (e.g., 1, 4, 10, 34)
4. For "5th+ Reminders Interval", enter how often to repeat (e.g., 24 for daily, 12 for twice daily)
5. Click "Save"

💡 Note: Changes apply to new PRs only. Existing open PRs keep their current schedule.

Weekly Statistics

Get weekly summaries of your team's PR activity per repository, including review times, merged PRs, and top contributors.

Enabling Weekly Stats

1. In the Home Tab, click "Edit" on a repository
2. Check "Enable Weekly Stats"
3. Select the day (e.g., Friday)
4. Enter the time in 24-hour format (e.g., 17:00)
5. Click "Save"

On-Demand Stats

Don't want to wait for the weekly schedule? Get stats instantly:

• Click "📈 This Week's Stats" next to any repo
• Click "📊 Last Week's Stats" for previous week
• Stats are posted to the repository's configured channel

What's Included

• Total PRs opened and merged
• Average review time
• Top reviewers leaderboard (🥇🥈🥉)
• Review participation rate

GitHub Organizations

Manage your GitHub App installations and organization links.

Link an Organization

1. In the Home Tab, click "Add Organization"
2. You'll be redirected to GitHub
3. Select the organization or personal account
4. Choose which repositories to authorize
5. After installation, you're automatically redirected back
6. Your Home Tab refreshes with the new organization

Unlink an Organization

1. Go to GitHub → Settings → Applications
2. Find "Nudgy Bot" in Installed GitHub Apps
3. Click "Configure" then "Uninstall"
4. All repositories from that org are automatically removed from your Slack