Vérifiez automatiquement si votre dépôt est éligible aux programmes d'avantages OSS.

Utilisation

ossperks check [options]

Alias : ossperks ck

Exécutez ceci depuis n'importe quel dépôt Git. Aucun argument ni jeton requis pour les dépôts publics.

Options

Indicateur	Description
`--repo <owner/repo>`	Spécifier explicitement un dépôt (par ex. `vercel/next.js`)
`--provider <provider>`	Fournisseur Git : `github`, `gitlab`, `codeberg` ou `gitea` (par défaut : `github`)
`-p, --program <id>`	Vérifier uniquement par rapport à un programme spécifique (par ex. `--program vercel`)
`-i, --interactive`	Sélectionner les programmes de manière interactive (groupés par catégorie ; TTY uniquement, pas avec `--json` ou `--program`)
`--json`	Afficher le JSON brut
`-h, --help`	Afficher l'aide

Fonctionnement

ossperks check s'exécute entièrement automatiquement :

ossperks check
      │
      ▼
Lire package.json (champ repository)
      │  ← non trouvé ?
      ▼
Lire .git/config (remote.origin.url)
      │
      ▼
Détecter le fournisseur (github.com / gitlab.com / codeberg.org / gitea.com)
      │
      ├─ GitHub   → GET /repos/:owner/:repo
      ├─ GitLab   → GET /api/v4/projects/:id
      ├─ Codeberg → GET /api/v1/repos/:owner/:repo
      └─ Gitea    → GET /api/v1/repos/:owner/:repo
      │
      ▼
RepoContext (étoiles, licence, âge, activité...)
      │
      ▼
Correspondance des règles d'éligibilité pour chaque programme
      │
      ▼
Afficher les résultats

Détection du dépôt

Lorsque --repo n'est pas spécifié, l'outil lit l'URL de votre dépôt depuis l'un de ces deux emplacements, dans l'ordre :

Champ repository dans package.json
remote.origin.url dans .git/config

Les formats d'URL HTTPS / SSH de GitHub, GitLab, Codeberg et Gitea sont pris en charge.

Correspondance d'éligibilité

Les chaînes d'éligibilité sont des règles en langage naturel telles que :

"Must be an open-source project" → vérifie la présence d'une licence approuvée par l'OSI
"Must have at least 100 GitHub stars" → vérifie stars >= 100
"Project must be at least 3 months old" → vérifie l'ancienneté du dépôt
"Must be actively maintained" → vérifie la présence de commits récents

La correspondance est heuristique — elle analyse les seuils et mots-clés du texte de la règle. Les cas limites sont marqués comme ? (inconnu) plutôt que comme un échec catégorique.

Exemples


# Vérifier tous les programmes depuis votre dépôt actuel

ossperks check

# Vérifier un dépôt spécifique sans être à l'intérieur

ossperks check --repo vercel/next.js

# Vérifier un projet GitLab

ossperks check --repo group/project --provider gitlab

# Vérifier uniquement un programme spécifique

ossperks check --program vercel

# Choisir interactivement les programmes à vérifier (interface terminal)

ossperks check --interactive

# Sortie JSON pour les scripts

ossperks check --json

Sortie

✅ my-project — MIT · 412 étoiles · dernier push il y a 3 jours

Éligibilité pour 48 programmes — 12 éligibles, 8 nécessitent un examen, 28 non éligibles

  ✅  Vercel for Open Source                         Probablement éligible — projet open source
  ✅  Netlify Open Source Plan                      Probablement éligible — projet open source
  ⚠️  GitHub Copilot Pro for Open Source Maintainers Nécessite un examen — révision manuelle requise
  ❌  DigitalOcean Open Source Credits             Probablement non éligible — pas assez d'étoiles GitHub

Statuts :

✅ Probablement éligible — toutes les règles d'éligibilité analysées correspondent
⚠️ Nécessite un examen — au moins une règle n'a pas pu être évaluée automatiquement
❌ Probablement non éligible — une ou plusieurs règles ne correspondent clairement pas

Vérifiez toujours sur la page officielle du programme avant de postuler.

ossperks check