OSS Perks

CLI de ossperks

Explora programas de beneficios OSS y verifica si tu proyecto califica — directamente desde la terminal.

Descripción general

ossperks es una herramienta de línea de comandos sin configuración que te permite:

  • Listar todos los programas de beneficios OSS en un solo lugar
  • Buscar programas por palabra clave, proveedor o categoría
  • Mostrar detalles completos de cualquier programa (beneficios, elegibilidad, cómo aplicar)
  • Verificar si tu propio repositorio califica para los programas — automáticamente, obteniendo datos en vivo desde la API de GitHub o GitLab
  • Abrir el sitio web de ossperks directamente desde la terminal

Instalación

npm install -g ossperks

O ejecutar sin instalar:

npx ossperks

Inicio rápido


# Listar todos los programas

ossperks list

# Verificar tu proyecto actual

cd /ruta/a/tu/repositorio
ossperks check

# Buscar por palabra clave

ossperks search "hosting"

# Mostrar detalles del programa

ossperks show vercel

# Abrir ossperks.com en tu navegador

ossperks open

Alias de comandos

Cada comando tiene alias cortos para mayor comodidad:

ComandoAlias
listls
showinfo
searchfind, s
checkck
categoriescats

Cómo funciona la detección de repositorios

ossperks check detecta automáticamente tu repositorio sin ninguna solicitud:

  1. Lee el campo repository del package.json en el directorio actual
  2. Recurre a analizar remote.origin.url del .git/config
  3. Llama a la API pública de GitHub, GitLab, Codeberg o Gitea para obtener datos en vivo (estrellas, licencia, actividad, etc.)
  4. Compara esos datos con las reglas de elegibilidad de cada programa

No se requieren tokens de API para repositorios públicos.

Telemetría

La CLI recopila estadísticas de uso anónimas (nombre del comando, versión, SO) para ayudar a mejorar la herramienta. Nunca se recopilan nombres de repositorios, nombres de usuario o información personal.

Para excluirte, establece cualquiera de estas variables de entorno:

export DO_NOT_TRACK=1

# o

export DISABLE_TELEMETRY=1

Notificaciones de actualización

Cuando hay una versión más reciente disponible en npm, la CLI muestra un aviso de una línea después de la salida del comando. La verificación se almacena en caché localmente durante 1 hora y nunca bloquea la ejecución del comando.

Próximos pasos

  • list — explorar todos los programas
  • show — ver detalles del programa
  • check — verificar automáticamente la elegibilidad de tu repositorio
  • search — buscar programas por palabra clave
  • categories — explorar por categoría (interactivo en una TTY)

On this page