GitHub App
The Precogs GitHub App integrates directly into your GitHub workflow, providing automated security scanning on every pull request.
Installation
- Visit the Precogs GitHub App page.
- Click Install and select your organization or repositories.
- Authorize the requested permissions.
How It Works
Once installed, Precogs will:
- Automatically scan every new pull request
- Post inline comments on security findings
- Update PR status checks with scan results
Configuration
Create a .precogs.yaml file in your repository root to customize scanning behavior:
# .precogs.yaml
scan:
enabled: true
languages:
- python
- javascript
severity_threshold: medium
Permissions Required
| Permission | Reason |
|---|---|
| Read code | To analyze your source code |
| Read/Write pull requests | To post findings as comments |
| Read/Write checks | To update PR status |
Next Steps
- Quickstart Guide — See your first finding
- Python SDK — Programmatic access