How to Install and Set Up the Scrummy Chrome Extension

The Scrummy Chrome extension brings time tracking and AI ticket improvements directly to your browser. Track time without switching tabs and enhance your Linear and GitHub tickets with AI-powered suggestions.

What the Extension Does

The Scrummy Chrome extension provides two main capabilities:

Time Tracking

• One-click timer: Start and stop a timer from any tab without leaving your current page
• Quick entry: Log time manually with smart duration parsing (e.g., "2h 30m")
• Recent tasks: Quickly select from your most recent work items
• Mini dashboard: See your daily and weekly totals at a glance

AI Product Owner

• Linear integration: AI improvement buttons appear directly on Linear ticket pages
• GitHub integration: Enhance GitHub issues with AI-powered suggestions
• Smart suggestions: Get title improvements, description enhancements, and acceptance criteria

Installation

Step 1: Download from Chrome Web Store

1. Open Google Chrome and visit the Chrome Web Store
2. Search for "Scrummy" or follow the direct link from your Scrummy dashboard
3. Click Add to Chrome
4. In the confirmation dialog, click Add extension

Step 2: Pin the Extension

1. Click the puzzle piece icon in your Chrome toolbar (Extensions menu)
2. Find "Scrummy" in the list
3. Click the pin icon next to it
4. The Scrummy icon now appears in your toolbar for quick access

Sign In

Connecting to Your Scrummy Account

1. Click the Scrummy icon in your browser toolbar
2. Click Sign In to Scrummy
3. You will be redirected to the Scrummy login page
4. Log in with your existing Scrummy credentials (email OTP or Google)
5. Grant the extension permission to access your account
6. You will be redirected back and the extension will show your dashboard

Tip: Make sure you are already logged in to Scrummy in the same browser for the smoothest experience.

Connect Integrations

Setting Up Linear

For AI Product Owner features on Linear:

1. Go to Scrummy > Company Settings > Integrations
2. Click Connect next to Linear
3. Authorize Scrummy to access your Linear workspace
4. Select which teams to sync
5. Visit any Linear ticket page and you will see the AI improvement buttons

Setting Up Jira

For time tracking with Jira tasks:

1. Go to Scrummy > Company Settings > Integrations
2. Click Connect next to Jira
3. Authorize Scrummy to access your Jira instance
4. Select your project
5. Your Jira tasks will appear in the extension timer task selector

Setting Up GitHub

For AI Product Owner features on GitHub:

1. Go to Scrummy > AI Product Owner page
2. Click Connect GitHub
3. Authorize Scrummy to access your repositories
4. Select repositories for AI analysis
5. Visit any GitHub issue page and you will see the AI enhancement buttons

Using Time Tracking

Starting a Timer

1. Click the Scrummy icon in your toolbar
2. Select a task from your recent tasks, or type to search
3. Click Start Timer
4. The extension icon shows a running indicator
5. Continue working - the timer runs in the background

Stopping a Timer

1. Click the Scrummy icon
2. Click Stop Timer
3. Add optional notes about what you worked on
4. Mark as billable if applicable
5. Click Save Entry

Manual Time Entry

1. Click the Scrummy icon
2. Click Add Time (or the + button)
3. Enter the duration (e.g., "1h 30m", "90m", or "1.5h")
4. Select the task
5. Add a description (optional)
6. Choose the date (defaults to today)
7. Click Save

Viewing Your Dashboard

1. Click the Scrummy icon
2. The mini dashboard shows:
   • Today's total tracked time
   • This week's total
   • Recent time entries
   • Running timer status

Using AI Product Owner

On Linear Tickets

1. Navigate to any Linear ticket page
2. Look for the AI Improve button near the ticket title
3. Click it to analyze the ticket
4. Review the AI suggestions:
   • Title: Clearer, more descriptive title
   • Description: Enhanced with more detail and context
   • Acceptance Criteria: Auto-generated based on the ticket content
5. Click Apply to update the ticket, or Dismiss to skip

On GitHub Issues

1. Navigate to any GitHub issue page
2. Look for the AI Enhance button
3. Click for AI-powered improvements
4. Review and apply the suggested changes
5. The AI uses your repository context for relevant suggestions

Permissions

The extension requests the following permissions:

| Permission | Why It Is Needed | |------------|-----------------| | scrummy.pro | Access your Scrummy account and sync data | | linear.app | Display AI improvement buttons on ticket pages | | github.com | Display AI enhancement buttons on issue pages | | Storage | Remember your login session and preferences |

The extension only activates on these specific domains and does not track your browsing activity on other websites.

Troubleshooting

Extension Icon Not Appearing

1. Check that the extension is installed: go to chrome://extensions
2. Make sure it is enabled (toggle should be on)
3. Pin it to your toolbar (click the puzzle piece icon)
4. Try restarting Chrome

Cannot Sign In

1. Make sure you have an active Scrummy account
2. Try logging in to scrummy.pro in a regular tab first
3. Clear the extension data: right-click the icon > Options > Clear Data
4. Reinstall the extension if the issue persists

AI Buttons Not Showing on Linear/GitHub

1. Verify your Linear or GitHub integration is connected in Scrummy Settings
2. Make sure you are on an actual ticket/issue page (not a list view)
3. Check that your Scrummy plan includes AI Product Owner (Pro plan required)
4. Try refreshing the page
5. Check the extension console for errors: right-click icon > Inspect popup

Timer Not Syncing

1. Check your internet connection
2. Click the Scrummy icon and verify you are still signed in
3. Try signing out and signing back in
4. Check if your Scrummy account is still active
5. Clear extension cache: right-click icon > Options > Clear Cache

Extension Slowing Down Chrome

1. Make sure you are running the latest version of Chrome
2. Check for conflicting extensions
3. Disable and re-enable the Scrummy extension
4. Report the issue to support@scrummy.pro with your Chrome version

Frequently Asked Questions

Does the extension work with other browsers?

Currently, the extension is available for Google Chrome and Chromium-based browsers (Edge, Brave, Arc). Firefox support is planned for a future release.

Is my data secure?

Yes. Authentication tokens are stored securely in the browser's extension storage. All communication with Scrummy servers uses HTTPS encryption. The extension does not collect browsing history or personal data outside of Scrummy, Linear, and GitHub domains.

Can I use the extension without a paid plan?

Time tracking features are available on all plans including Free. AI Product Owner features require a Pro plan.

How do I update the extension?

Chrome automatically updates extensions from the Web Store. To check your version, click the extension icon and look at the bottom of the popup, or visit chrome://extensions.

Can I use the extension on multiple computers?

Yes. Install the extension on each computer and sign in with your Scrummy account. Your time entries and settings sync automatically.

How do I uninstall the extension?

Right-click the Scrummy icon in your toolbar and select Remove from Chrome, or go to chrome://extensions, find Scrummy, and click Remove.

Support

Need help with the Chrome extension? Here is how to get support:

• Email: support@scrummy.pro
• Knowledge Base: Browse all articles
• In-App Chat: Click the Help button in the Scrummy web app

When contacting support about extension issues, please include:

• Your Chrome version (find it at chrome://version)
• Extension version (shown in the extension popup footer)
• Steps to reproduce the issue
• Screenshots if applicable