Getting Started

Coming Soon — Expected release: February 16, 2026. Awaiting store publication.

Complete setup guide for the GitScrum Chrome Extension with all configuration options.

Prerequisites

Before you begin, ensure you have:

• A GitScrum account with an active subscription
• Google Chrome, Microsoft Edge, Brave, or any Chromium-based browser
• Access to at least one GitScrum workspace

Installation

Chrome Web Store

For Google Chrome, Brave, Arc, and Opera browsers:

1. Visit the GitScrum Chrome Extension page
2. Click Add to Chrome
3. Click Add extension in the confirmation dialog
4. The GitScrum icon appears in your browser toolbar

Microsoft Edge Add-ons

For Microsoft Edge browser:

1. Visit the GitScrum Edge Extension page
2. Click Get
3. Click Add extension in the confirmation dialog
4. The GitScrum icon appears in your browser toolbar

Pin the Extension

For quick access, pin the extension to your toolbar:

1. Click the puzzle icon in the toolbar
2. Find GitScrum in the list
3. Click the pin icon next to it

Manual Installation

For development or testing:

1. Clone or download the extension source
2. Open chrome://extensions/ in your browser
3. Enable Developer mode (top right toggle)
4. Click Load unpacked
5. Select the extension dist folder
6. The extension loads with a unique ID

Authentication

Email and Password

1. Click the GitScrum icon
2. Enter your registered email address
3. Enter your password
4. Click Sign in

Multi-Factor Authentication

If MFA is enabled on your account:

1. After entering email and password, a code field appears
2. Open your authenticator app (Google Authenticator, Authy, etc.)
3. Enter the 6-digit code
4. Click Verify

MFA codes refresh every 30 seconds. If a code fails, wait for a new code.

OAuth Providers

Sign in with a connected social account:

1. Click your preferred provider button
2. A popup window opens for authentication
3. Complete the sign-in in the popup
4. The popup closes and you are signed in

Note: OAuth providers must be connected to your GitScrum account in your profile settings before using them in the extension.

Workspace Configuration

Selecting a Workspace

After signing in:

1. Click the Workspace dropdown
2. Select your workspace from the list
3. The projects dropdown updates with that workspace's projects

Selecting a Project

1. Click the Project dropdown
2. Select the project where you want to create tasks
3. Your selection is saved for future sessions

Switching Workspaces

You can switch workspaces at any time:

1. Click the current workspace name
2. Select a different workspace
3. The project dropdown resets
4. Select a project from the new workspace

Extension Interface

Popup Layout

The extension opens as a 400×580px popup with these sections:

Task Tab

The default view for creating tasks:

• Title field — Required
• Description field — Optional, supports markdown
• Quick options — Workflow, priority, assignee, labels, time estimate
• Create button — Submit the task

Screenshot Tab

Capture and attach screenshots:

• Capture button — Captures the current tab
• Preview panel — Shows captured screenshot
• Attach toggle — Include screenshot with next task

Browser Permissions

The extension requests these permissions:

Why these permissions?

• activeTab — Only activates when you click the extension icon. Never runs in background.
• storage — Stores your auth token and workspace selection locally. Uses Base64 obfuscation.
• tabs — Reads current tab URL to auto-fill task context. Does not track browsing history.

Troubleshooting

Extension Icon Missing

1. Click the puzzle icon in toolbar
2. Find GitScrum in the list
3. Click the pin icon

Sign In Failed

1. Verify your email and password in the main GitScrum app
2. Check if MFA is required but not entered
3. Clear extension storage: right-click icon → Manage extension → Clear site data

OAuth Popup Blocked

1. Check browser popup blocker settings
2. Allow popups from extension
3. Try clicking the OAuth button again

Workspaces Not Loading

1. Verify your GitScrum subscription is active
2. Check your internet connection
3. Sign out and sign in again

Next Steps

• Task Creation — Complete task creation workflow
• Screenshots — Capture and annotate screenshots
• Authentication — Security and account management