ossperks CLI

개요

ossperks는 설정이 필요 없는 커맨드라인 도구로 다음과 같은 기능을 제공합니다:

• 목록 보기 모든 OSS 혜택 프로그램을 한곳에서 확인
• 검색 키워드, 제공업체 또는 카테고리로 프로그램 검색
• 상세 정보 모든 프로그램의 전체 세부 정보 표시 (혜택, 자격 요건, 신청 방법)
• 확인 GitHub 또는 GitLab API에서 실시간 데이터를 가져와 자동으로 내 저장소가 프로그램 자격 요건을 충족하는지 확인
• 열기 터미널에서 직접 ossperks 웹사이트 열기

설치

npm install -g ossperks

또는 설치 없이 실행:

npx ossperks

빠른 시작

# 모든 프로그램 목록 보기

ossperks list

# 현재 프로젝트 확인

cd /path/to/your/repo
ossperks check

# 키워드로 검색

ossperks search "hosting"

# 프로그램 세부 정보 표시

ossperks show vercel

# 브라우저에서 ossperks.com 열기

ossperks open

명령어 별칭

모든 명령어는 편의를 위한 단축 별칭을 제공합니다:

저장소 감지 작동 방식

ossperks check는 별도의 입력 없이 자동으로 저장소를 감지합니다:

1. 현재 디렉터리의 package.json에서 repository 필드를 읽습니다
2. .git/config의 remote.origin.url을 파싱하는 방식으로 대체합니다
3. GitHub, GitLab, Codeberg 또는 Gitea 공개 API를 호출하여 실시간 데이터(스타 수, 라이선스, 활동 등)를 가져옵니다
4. 해당 데이터를 모든 프로그램의 자격 요건 규칙과 대조합니다

공개 저장소에는 API 토큰이 필요하지 않습니다.

원격 분석

CLI는 도구 개선을 위해 익명 사용 통계(명령어 이름, 버전, OS)를 수집합니다. 저장소 이름, 사용자 이름 또는 개인 정보는 절대 수집되지 않습니다.

수집을 거부하려면 다음 환경 변수 중 하나를 설정하세요:

export DO_NOT_TRACK=1

# 또는

export DISABLE_TELEMETRY=1

업데이트 알림

npm에서 최신 버전이 제공되면 CLI는 명령 출력 후 한 줄 알림을 표시합니다. 확인은 로컬에 1시간 동안 캐시되며 명령 실행을 차단하지 않습니다.

다음 단계

• list — 모든 프로그램 탐색
• show — 프로그램 세부 정보 보기
• check — 저장소 자격 자동 확인
• search — 키워드로 프로그램 검색
• categories — 카테고리별 탐색 (TTY에서 대화형)