Connect your repo

Install the PulseLight GitHub App, pick the repos PulseLight can read, and run your first scan.

What the GitHub App can and can’t do

Read-only. The PulseLight GitHub App requests only the permissions needed to clone your repo and post a check run. It cannot open PRs, push commits, or modify your code.

Specifically, the App requests:

  • Repository contents (read) — to clone the repo for scanning.
  • Metadata (read) — default for any GitHub App, lists your repos.
  • Pull requests (read & write) — to post a single calm comment summarising the scan, and a non-blocking GitHub Check Run. Optional — disable per-project.

Install the GitHub App

01

Open the install flow.

From the dashboard, click Add a project. PulseLight redirects to GitHub’s install screen.

02

Choose the install scope.

Pick your personal account or an org. If you install for an org, GitHub admins get a confirmation; PulseLight still works while approval is pending for non-admin users.

03

Pick which repos PulseLight can read.

You can choose All repositories or a specific list. We recommend starting with one repo; add more from the install settings any time.

04

Confirm the install.

GitHub redirects you back to PulseLight. The repo you picked is now connected and ready to scan.

Adding more repos later

From Settings → GitHub connections, click the installation row to open GitHub’s app settings. Pick additional repos there and they appear back in PulseLight on your next page load.

Removing access

Remove the PulseLight GitHub App from your account or org via GitHub’s Settings → Applications → Installed GitHub Apps. PulseLight retains your scan history (you can re-install at any time and pick up where you left off), or delete the workspace from Settings → Billing to purge.

Self-hosted GitHub Enterprise

Currently PulseLight supports github.com only. Enterprise Server support is on the roadmap — get in touch if this matters for your team.

Common errors

E: GitHub App install failed: 'invalid_scope'
   Cause: org admin rejected the install.
   Fix:   ask your GitHub admin to approve the App, or
          install on a personal account first.