Feature - WorkerB

1. Connect Slack to LinearB (one-time, workspace-level)

1. In LinearB, go to Settings → Company Settings.
2. Select the Slack tab.
3. Click Connect Slack and approve the Slack permissions.

After connecting, you’ll see your LinearB teams listed with a Slack channel column.

2. Connect a LinearB team to a Slack channel

1. In Company Settings → Slack, find the team you want to connect.
2. Click Connect (or the pencil icon) and choose a public Slack channel.
3. Click Save.

LinearB posts a confirmation message in the selected channel with a Sign me up! button. Team members can click it to start using WorkerB personal alerts and commands.

You can later adjust which alerts this team receives via:
Company Settings → Slack → Edit Notifications or Team Settings → Notifications.

3. Enable WorkerB personal alerts in Slack

Connect your Slack user

1. In Slack, type /lb connect in any channel or DM.
2. If you’re not connected yet, click Let’s do it! in the WorkerB prompt.
3. Authenticate in LinearB using your Git provider login.

Once linked, WorkerB starts sending personal notifications and allows you to run WorkerB slash commands.

Choose which alerts you get

1. In Slack, type /lb pref.
2. Use the Personal Preferences panel to enable / disable alert types.
3. Click Save.

4. Use WorkerB Slack commands

Use these commands in Slack once you’re connected:

• /lb help – See available commands.
• /lb updates – View recent activity on your PRs and reviews.
• /lb reviews – List PRs waiting for your review.
• /lb prs – List all open PRs you’ve authored.
• /lb prs long – Find PRs that have been open for a long time.
• /lb prs done – Show recently completed PRs.
• /lb pref – Open personal notification preferences.
• /lb invite – Invite teammates to connect WorkerB.
• /lb unlink – Disconnect your Slack and Git accounts.

5. Connect WorkerB to a private Slack channel

1. First, connect the team to any public channel from Company Settings → Slack.
2. In the private Slack channel, mention the bot (for example: @LinearB Bot or @WorkerB) to invite it.
3. Please contact support with:
   • Your LinearB organization name.
   • The LinearB team name.
   • The private Slack channel name and channel ID.
4. Support will map the team to the private channel and confirm once alerts are routed correctly.

After setup, you can manage alerts for that team the same way as any other channel.

1. Install WorkerB in Microsoft Teams

1. Open the Microsoft Teams Admin Center.
2. Upload the WorkerB.zip app package as a custom app (re-zip first if it was unzipped).
3. After upload, locate WorkerB under Apps and allow / install it for your organization.

2. Connect Microsoft Teams in LinearB

1. In LinearB, go to Settings → Company Settings → Microsoft Teams.
2. Click Connect and approve the permissions request.
3. After connection, LinearB shows a public invitation link. Share this with your team so users can link their accounts.

3. Link a LinearB team to a Teams channel

1. In Teams, open the WorkerB bot.
2. Type link team (or link team -s to search when you have many teams).
3. Select the LinearB team and the Microsoft Teams team.
4. Select the channel where you want WorkerB alerts to appear.
5. Optionally, choose to invite all team members so they receive a personal invite card.
6. Confirm to complete the setup. A confirmation message appears in the channel.

4. Connect individual users in Teams

Link your Teams user

1. Click the WorkerB invite link shared by your admin, then click Add.
2. Open the WorkerB chat and type LinkUser.
3. Click Link my account and log in via your Git provider.

After authentication, WorkerB confirms the connection in Teams.

Configure personal preferences

1. In the WorkerB chat, type Pref.
2. Select which personal alerts you’d like to receive.
3. Click Save.

5. Teams bot commands

Use these commands in the WorkerB chat:

• Help – List available WorkerB commands.
• LinkUser – Link your Teams user to LinearB.
• Invite – Invite teammates to enable personal notifications.
• Pref – Open personal alert preferences.
• Prs – List your open PRs.
• Prs long – List long-open PRs.
• Prs done – Show recently completed PRs.
• Updates – Show latest updates on your PRs.
• Reviews – List PRs awaiting your review.
• Unlink – Disconnect your Teams user from LinearB.

Estimated Review Time appears in WorkerB notifications and commands, giving reviewers a quick estimate of how long it will take to complete an initial review of a PR.

LinearB starts with a global model based on anonymized customer data, then gradually adapts to your organization’s historical review patterns. The estimate model is recalculated regularly as more data is collected.

You’ll see Estimated Review Time in:

• Slack / Teams personal alerts when you’re assigned a review.
• /lb updates and related commands listing PRs and reviews.
• Some team alerts focused on review pickup and duration.

For GitHub organizations using Slack WorkerB alerts, WorkerB can show the diff of very small PRs (fewer than 5 lines of code changed) directly inside a Slack DM and let you approve the PR inline.

The first time you click Approve, WorkerB prompts you to authorize LinearB to approve PRs on your behalf via GitHub OAuth. After you grant permission, you can approve future tiny PRs from Slack with a single click.

If the PR changes (for example, new commits or comments) before you approve, WorkerB will prevent automatic approval and prompt you to review again in GitHub.

When a non-draft PR remains unassigned for more than ~2 minutes, WorkerB can send the author a DM suggesting they share it with a team channel.

The DM includes key context (PR link, number of files, lines changed, and Estimated Review Time) and lets the author:

• Share — send this one PR to a chosen channel, or
• Always share PRs — automatically share unassigned PRs from that repo going forward.

To post into private channels, make sure the @LinearB / WorkerB bot is a member of the channel.

When a branch or PR isn’t linked to a Jira ticket, WorkerB can prompt the author in Slack to either create or edit a Jira issue directly from the alert.

Enable the alert

1. In Slack, type /lb pref.
2. Enable the option for Jira ticket for unlinked branch.

From the WorkerB alert

• Create Ticket — WorkerB creates a Jira issue using the PR details (project, issue type, summary).
• Edit — adjust project / type / summary before creating.

The first time you use this feature, you’ll be asked to connect your personal Jira account to WorkerB so it can create issues on your behalf.

When a GitHub team is requested as a reviewer on a PR, WorkerB can notify up to five members of that team with a DM containing the PR link and Estimated Review Time.

Requirements:

• Team members must have WorkerB connected (Slack personal alerts enabled).
• For some organizations, LinearB may require updated GitHub permissions (for example, read:org) and a brief re-authorization of the Git connection.

Symptom: A user tries to connect via Slack or Teams but sees no data or the link fails.

Cause: WorkerB only links users who are recognized as contributors — people with at least one commit in a Git repository connected to LinearB.

Fix:

• Have the user push at least one commit to a connected repo.
• Wait a few minutes for LinearB to process the new contributor.
• Ensure the email in Git matches the email used in Slack / Teams.

If the person is not meant to be a contributor (for example, PM or designer), they can still follow team-level alerts in channels but won’t have personal WorkerB alerts.

When LinearB adds features that require additional Slack scopes, you’ll see a banner asking to reauthorize.

1. In LinearB, open Company Settings → Slack.
2. Click Reauthorize Slack and accept the updated permissions.

Verify that the WorkerB / LinearB bot is invited to the channel and that Support has mapped the team to the private channel as described above. Alerts can only post where the bot is a member.

Your Slack workspace admin may need to re-authorize the LinearB app to grant the updated permission scopes. Look for a reauthorization banner in Slack’s App settings or in the LinearB Slack integration page.