Getting Started
Installation
Install FixSense as a GitHub App and start analyzing CI failures in under 2 minutes.
Prerequisites
Before installing FixSense, make sure you have:
- A GitHub account (personal or organization)
- At least one repository with Playwright or Cypress tests
- GitHub Actions or GitLab CI as your CI provider
Step 1: Install the GitHub App
- Go to FixSense and click Get Started
- Sign in with your GitHub account
- Click Install GitHub App
- Select the repositories you want to monitor
- Approve the required permissions
FixSense only needs read access to your code and CI logs, plus write access to post PR comments and create fix branches.
Step 2: Trigger a CI Run
Once installed, FixSense automatically monitors your CI pipeline. To test it:
- Open a Pull Request with a change that might affect your tests
- Wait for your tests to run in CI
- If any tests fail, FixSense will post an analysis comment on the PR within 30 seconds
Step 3: View Your Dashboard
Visit your FixSense Dashboard to see:
- Total analyses used this month
- Auto-fix usage
- Recent failure analyses
- Failure trends over time
Permissions Explained
| Permission | Why We Need It |
|---|---|
| Contents (Read & Write) | Read test files for context, push auto-fix branches |
| Pull Requests (Read & Write) | Post analysis comments on PRs |
| Actions (Read) | Download CI failure logs |
| Issues (Read & Write) | Create issues for persistent failures |
| Workflows (Read & Write) | Enable auto-fix workflow via dashboard |
| Metadata (Read) | Basic repository information |