Linear-Slack Reminder Bot monitors Linear tickets and sends scheduled Slack reminders to assignees.

You may also trigger and use this bot through adding a chase Linear label - the statuses of your Linear tickets with the label will always be synced with the Slack bot.

1. Track a ticket using /track-linear [ticket-id]
2. Configure reminders - Choose how often to ping (daily, every 2 days, etc.)
3. Automatic notifications - The bot sends DMs to assignees of incomplete tickets
4. Escalation - After 3 reminders, the ticket creator is also notified
5. Completion - When all tasks are done, the creator gets a success notification

1. You'll need the HTTP Request URL from main.ts. E.g. charmaine-17829713.val.run for Step 2 below.
2. You'll need to these environment variables:
   • SLACK_BOT_TOKEN - Your Slack bot token (see Step 2 below)
   • LINEAR_API_KEY - Your Linear API key (see Step 3 below)

1. Go to api.slack.com/apps and click "Create New App"

2. Choose "From scratch" and name it (e.g., "Linear Reminder Bot")

3. Navigate to OAuth & Permissions > Scopes > add these Bot Token Scopes:

   • chat:write - To send messages
   • users:read - To list workspace users
   • users:read.email - To match Linear users by email
   • commands - To handle slash commands
   • im:write - To send direct messages

4. Scroll up and click "Install to [Workspace Name]" and authorize the app

5. Copy the Bot User OAuth Token (starts with xoxb-)

6. Set up Slash Commands (under "Slash Commands" in sidebar):

   • Command: /track-linear
     • Note: you can change this command, but you'll also have to change it in slack/slashCommand.ts in this val
     • Request URL: https://[YOUR-VALTOWN-URL]/slack/commands (You get get this via the main.ts file)
     • Description: "Track a Linear ticket for reminders"
   • Command: /track-status
     • Request URL: https://[YOUR-VALTOWN-URL]/slack/commands
     • Description: "View your active Linear reminders"

7. Enable Interactivity (under "Interactivity & Shortcuts"):

   • Turn ON
   • Request URL: https://[YOUR-VALTOWN-URL]/slack/interactive

1. Open Linear and click your profile picture
2. Go to Settings → Account → Security & access
   • Direct link: https://linear.app/YOUR-WORKSPACE/settings/account/security
3. Under "Personal API keys", click "New API key"
4. Name it something memorable (e.g., "Val Town Slack Reminder Bot")
5. Give it full permissions and team access for easiest set up
6. Copy the key immediately - you won't be able to see it again!
7. Add it to Val Town as the LINEAR_API_KEY environment variable

/track-linear VAL-123

or

/track-linear https://linear.app/team/issue/VAL-123

This will open a modal where you can:

• Select the reminder interval (daily, every 2 days, etc.)
• Map Linear assignees to Slack users
• Configure who gets notified for unassigned tickets

/track-status

Shows all your active reminders with clickable links to Linear tickets.

Reminders automatically stop when:

• All tracked tickets are marked as complete in Linear
• The parent ticket is closed (for tickets with sub-tasks)

You may also manually clear all reminders with

/clear-reminders

1. Edit your cronChecker val in Val Town
2. Change const FORCE_RUN = false to true
3. Run the cron manually - it will send notifications immediately
4. Change back to false when done testing