Verifica automáticamente si tu repositorio califica para programas de beneficios OSS.

Uso

ossperks check [opciones]

Alias: ossperks ck

Ejecuta esto desde cualquier repositorio Git. No se requieren argumentos ni tokens para repositorios públicos.

Opciones

Bandera	Descripción
`--repo <owner/repo>`	Especificar explícitamente un repositorio (ej. `vercel/next.js`)
`--provider <provider>`	Proveedor Git: `github`, `gitlab`, `codeberg` o `gitea` (predeterminado: `github`)
`-p, --program <id>`	Verificar solo un programa específico (ej. `--program vercel`)
`-i, --interactive`	Seleccionar programas interactivamente (agrupados por categoría; solo TTY, no con `--json` o `--program`)
`--json`	Generar JSON sin procesar
`-h, --help`	Mostrar ayuda

Cómo funciona

ossperks check se ejecuta completamente de forma automática:

ossperks check
      │
      ▼
Leer package.json (campo repository)
      │  ← ¿no encontrado?
      ▼
Leer .git/config (remote.origin.url)
      │
      ▼
Detectar proveedor (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 (estrellas, licencia, antigüedad, actividad...)
      │
      ▼
Cotejar reglas de elegibilidad para cada programa
      │
      ▼
Mostrar resultados

Detección de repositorio

Cuando no se especifica --repo, la herramienta lee la URL de tu repositorio desde uno de dos lugares, en orden:

Campo repository en package.json
remote.origin.url en .git/config

Se admiten formatos de URL HTTPS / SSH de GitHub, GitLab, Codeberg y Gitea.

Cotejo de elegibilidad

Las cadenas de elegibilidad son reglas en lenguaje natural como:

"Must be an open-source project" → verifica una licencia aprobada por OSI
"Must have at least 100 GitHub stars" → verifica stars >= 100
"Project must be at least 3 months old" → verifica la antigüedad del repositorio
"Must be actively maintained" → verifica commits recientes

El cotejo es heurístico — analiza umbrales y palabras clave del texto de la regla. Los casos límite se marcan como ? (desconocido) en lugar de una falla definitiva.

Ejemplos


# Verificar todos los programas desde tu repositorio actual

ossperks check

# Verificar un repositorio específico sin estar dentro de él

ossperks check --repo vercel/next.js

# Verificar un proyecto de GitLab

ossperks check --repo grupo/proyecto --provider gitlab

# Verificar solo un programa específico

ossperks check --program vercel

# Elegir interactivamente qué programas verificar (interfaz de terminal)

ossperks check --interactive

# Salida JSON para scripting

ossperks check --json

Salida

✅ mi-proyecto — MIT · 412 estrellas · último push hace 3 días

Elegibilidad en 48 programas — 12 elegibles, 8 requieren revisión, 28 no elegibles

  ✅  Vercel for Open Source                         Probablemente elegible — proyecto de código abierto
  ✅  Netlify Open Source Plan                      Probablemente elegible — proyecto de código abierto
  ⚠️  GitHub Copilot Pro for Open Source Maintainers Requiere revisión — se necesita revisión manual
  ❌  DigitalOcean Open Source Credits             Probablemente no elegible — no hay suficientes estrellas en GitHub

Estados:

✅ Probablemente elegible — todas las reglas de elegibilidad analizadas coincidieron
⚠️ Requiere revisión — al menos una regla no pudo ser auto-evaluada
❌ Probablemente no elegible — una o más reglas claramente no coinciden

Siempre verifique contra la página oficial del programa antes de aplicar.

ossperks check

Uso