Integrations

Connect GitHub once. Assign people and repos to teams on Teams.

GitHub OAuth (device flow)

Lets developers run npx --yes @vsrox_dev/cliqq collect without pasting a key (GitHub device flow).

Not configured

Set GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET in your server environment. See docs/deploy.md.

Daily org-wide Copilot usage — server polls GitHub hourly. No per-developer install.

Not connected

How to create a fine-grained PAT

Open GitHub → New fine-grained token.
Resource owner: your GitHub organization (the one with Copilot).
Organization permissions → View Organization Copilot Metrics → Read.
Copy the token — you will paste it below once. It is stored encrypted and never shown again.

Connect once with a GitHub App. Then assign repos to teams on Teams.

Not connected

Connect GitHub repos

Install the Cliqq GitHub App, choose Only select repositories, and grant access. Repos sync hourly for Impact metrics.

GitHub App env not set. Add GITHUB_APP_CLIENT_ID, GITHUB_APP_CLIENT_SECRET, GITHUB_APP_SLUG, and GITHUB_APP_PRIVATE_KEY — see .env.example.

Advanced: PAT fallback and API keys

Fine-grained PAT (git sync fallback)

Use only if you cannot install a GitHub App (air-gapped / policy). PAT needs Contents read on each repo.

How to create a fine-grained PAT

Open GitHub → New fine-grained token.
Repository access: select the repos to track (or all org repos).
Repository permissions → Contents → Read; Metadata → Read.
Copy the token — paste it below once. It is stored encrypted and never shown again.

Create per-developer keys, revoke compromised keys, and track last ingest activity.

Name	Prefix	GitHub	Created	Last used	Status
local-dev	—	—	2026-08-29	—	Active