Chrome Extension
Manage test cases and cycles directly from GitHub using the TestKase browser extension.
Overview
The TestKase Chrome Extension adds a side panel to GitHub issue pages, giving you full test management capabilities without leaving your browser. When you navigate to any issue on github.com, the extension detects the page, identifies the repository, and displays linked test cases, test cycles, and available actions in a convenient side panel. Every action you perform syncs back to TestKase in real time.
Side panel UI
A dedicated panel appears alongside GitHub issues for instant access
Create test cases
Create and link test cases directly from any GitHub issue
AI generation
Generate test cases from GitHub issue context using AI
Test cycles
Create and manage test cycles from the side panel
Test execution
Execute tests and record results without leaving GitHub
Requirements & defects
Connecting for requirements automatically covers defects too
Prerequisites
Before using the Chrome Extension with GitHub, make sure you have:
- Google Chrome browser (latest version recommended).
- An active TestKase account with at least one project.
- A Personal Access Token (PAT) generated from TestKase under Settings -> API Keys. See API Keys for details.
- A GitHub account with access to the repository you want to connect.
Installation
- Visit the Chrome Web Store and search for "TestKase".
- Click the TestKase extension listing.
- Click Add to Chrome and confirm the permissions prompt.
- Once installed, click the Extensions icon (puzzle piece) in the Chrome toolbar.
- Click the pin icon next to TestKase to keep it visible in your toolbar for easy access.
Pinning the extension to your toolbar makes it easy to open the side panel on any supported page with a single click.
Setup
After installation, you need to authenticate and map your project:
- Log in with your PAT -- Open the extension (click the TestKase icon in the toolbar) and enter your Personal Access Token. The extension validates the token and connects to your TestKase account.
- Map a TestKase project to your GitHub repository -- Select the TestKase project you want to link to the GitHub repository you are working in. This mapping tells the extension which TestKase project to use when you navigate to issues in that repository.
Once the mapping is saved, the extension is ready to use. Navigate to any issue in the mapped GitHub repository and the side panel will activate automatically.
Each project mapping connects one TestKase project to one GitHub repository. If you work across multiple repositories, you can set up additional mappings from the extension settings.
How It Works
- Navigate to a GitHub issue -- Open any issue page on github.com (e.g.,
https://github.com/your-org/your-repo/issues/42). - Extension detects the platform -- The extension recognizes that you are on a GitHub issue page and checks whether a project mapping exists for that repository.
- Side panel activates -- If a mapping is configured, the side panel opens and displays the test cases and test cycles linked to that issue, along with available actions.
- Perform actions -- Create test cases, link existing ones, generate tests with AI, manage cycles, and execute tests -- all from the side panel.
- Automatic sync -- Every action syncs back to TestKase in real time. Test cases created from the extension appear in your TestKase project immediately.
Key Features
Create Test Cases from GitHub Issues
Create new test cases directly from any GitHub issue. The extension pre-populates context from the issue (title, body) so you can quickly define test steps and expected results without switching tabs.
Link and Unlink Test Cases
Link existing test cases from your TestKase project to the current GitHub issue. You can search by name or ID, link multiple test cases at once, and unlink them when they are no longer relevant.
AI Test Generation
Generate test cases from the GitHub issue context using AI. The extension reads the issue title and body, then produces suggested test cases that you can review, edit, and save. This is especially useful for quickly building coverage for new feature requests or bug reports.
Test Cycle Management
Create new test cycles, link test cases to cycles, and manage cycle details from the side panel. You can view all cycles associated with the current issue and navigate between them without leaving GitHub.
Test Execution
Execute test cases from the side panel. Mark steps as passed, failed, or blocked, add comments, and record results -- all within the GitHub issue view. Execution results sync back to TestKase immediately.
Requirements and Defects
When you connect a TestKase project to a GitHub repository using the Chrome Extension, the mapping automatically covers both requirements and defects. There is no separate setup needed for each -- a single project mapping enables the full workflow:
- Requirements -- GitHub issues are accessible as requirement context for your test cases.
- Defects -- Defects created during test execution can be linked back to the GitHub issue.
This unified approach means you configure the connection once and get complete traceability between GitHub issues, test cases, and defects.
For API-based sync without a browser extension -- including automatic requirement import and bidirectional defect sync -- see API Integration.
Troubleshooting
▶The extension side panel is not appearing on GitHub issue pages
Check the following:
- Verify the extension is installed and enabled in
chrome://extensions. - Make sure you are on a GitHub issue page (URL should match
github.com/<owner>/<repo>/issues/<number>). - Confirm that you have mapped a TestKase project to this GitHub repository in the extension settings.
- Try refreshing the page. If the issue persists, click the TestKase icon in the toolbar to manually open the side panel.
▶My Personal Access Token is not being accepted
Your PAT may be expired or revoked. Steps to resolve:
- Go to TestKase Settings -> API Keys and check whether the token is still active.
- If it has expired, generate a new token.
- Copy the full token string (avoid leading or trailing spaces) and paste it into the extension login screen.
- If the issue persists, try logging out of the extension and logging back in with the new token.
▶Project mapping seems lost or the extension shows the wrong project
Project mappings are stored locally in the extension. They can occasionally be cleared if:
- The extension was updated or reinstalled.
- Browser data was cleared.
- Chrome profiles were switched.
Re-open the extension settings, select your TestKase project, and re-map it to the GitHub repository.
▶Actions in the side panel are slow or timing out
This is usually a network issue. Ensure you have a stable internet connection and that your TestKase instance is reachable. If you are behind a corporate VPN or firewall, verify it does not block traffic to the TestKase API.
Next Steps
API Integration
Connect TestKase to GitHub Issues for real-time requirement sync, defect push, and full traceability between your test management and development workflows.
GitLab
Two ways to connect TestKase with GitLab -- API integration for requirement sync and defect push, and Chrome Extension for browser-based access.
