ossperks check
귀하의 리포지토리가 OSS 혜택 프로그램 자격을 충족하는지 자동으로 확인합니다.
사용법
ossperks check [옵션]별칭: ossperks ck
모든 Git 저장소 내부에서 실행하세요. 공개 저장소의 경우 인수나 토큰이 필요하지 않습니다.
옵션
| 플래그 | 설명 |
|---|---|
--repo <owner/repo> | 저장소를 명시적으로 지정 (예: vercel/next.js) |
--provider <provider> | Git 제공자: github, gitlab, codeberg 또는 gitea (기본값: github) |
-p, --program <id> | 특정 프로그램만 확인 (예: --program vercel) |
-i, --interactive | 프로그램을 대화형으로 선택 (카테고리별로 그룹화됨; TTY 전용, --json 또는 --program과 함께 사용 불가) |
--json | 원시 JSON 출력 |
-h, --help | 도움말 표시 |
작동 방식
ossperks check는 완전 자동으로 실행됩니다:
ossperks check
│
▼
package.json 읽기 (repository 필드)
│ ← 찾을 수 없음?
▼
.git/config 읽기 (remote.origin.url)
│
▼
제공자 감지 (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 (스타, 라이선스, 기간, 활동...)
│
▼
모든 프로그램의 자격 규칙 매칭
│
▼
결과 출력저장소 감지
--repo가 지정되지 않은 경우, 도구는 다음 두 위치 중 하나에서 저장소 URL을 순서대로 읽습니다:
package.json의repository필드.git/config의remote.origin.url
GitHub, GitLab, Codeberg 및 Gitea HTTPS / SSH URL 형식이 지원됩니다.
자격 요건 일치
자격 요건 문자열은 다음과 같은 자연어 규칙입니다:
"Must be an open-source project"→ OSI 승인 라이선스 확인"Must have at least 100 GitHub stars"→stars >= 100확인"Project must be at least 3 months old"→ 저장소 연령 확인"Must be actively maintained"→ 최근 커밋 확인
일치는 휴리스틱 방식입니다 — 규칙 텍스트에서 임계값과 키워드를 파싱합니다. 경계 사례는 명확한 실패가 아닌 ? (알 수 없음)으로 표시됩니다.
예제
# 현재 저장소에서 모든 프로그램 확인
ossperks check
# 저장소 내부에 있지 않고 특정 저장소 확인
ossperks check --repo vercel/next.js
# GitLab 프로젝트 확인
ossperks check --repo group/project --provider gitlab
# 특정 프로그램만 확인
ossperks check --program vercel
# 확인할 프로그램을 대화형으로 선택 (터미널 UI)
ossperks check --interactive
# 스크립팅을 위한 JSON 출력
ossperks check --json출력
✅ my-project — MIT · 스타 412개 · 마지막 푸시 3일 전
48개 프로그램의 자격 요건 — 12개 적격, 8개 검토 필요, 28개 부적격
✅ Vercel for Open Source 적격 가능성 높음 — 오픈 소스 프로젝트
✅ Netlify Open Source Plan 적격 가능성 높음 — 오픈 소스 프로젝트
⚠️ GitHub Copilot Pro for Open Source Maintainers 검토 필요 — 수동 검토 필요
❌ DigitalOcean Open Source Credits 부적격 가능성 높음 — GitHub 스타 부족상태:
- ✅ 적격 가능성 높음 — 모든 파싱된 자격 요건 규칙이 일치함
- ⚠️ 검토 필요 — 하나 이상의 규칙을 자동으로 평가할 수 없음
- ❌ 부적격 가능성 높음 — 하나 이상의 규칙이 명확히 일치하지 않음
신청하기 전에 항상 해당 프로그램의 공식 페이지에서 확인하세요.