Kickbacks CLI

Kickbacks CLI: 터미널에서 관리하는 Kickbacks.ai 수익 및 광고 내역의 모든 것

Kickbacks CLI는 Kickbacks.ai 사용자들이 자신의 터미널에서 직접 실시간 상태, 현재 수익 및 광고 내역을 확인할 수 있도록 설계된 강력한 독립형 동반 도구입니다. 로컬 우선(Local-first) 원칙에 따라 설계되었으며, 기본적으로 안전하고 투명한 운영을 지향합니다. 이 가이드에서는 Kickbacks CLI의 주요 기능과 설치 방법, 그리고 보안 정책에 대해 자세히 살펴보겠습니다.

What's Kickbacks CLI?

Kickbacks CLI는 사용자의 Kickbacks.ai 활동을 터미널 환경에서 직관적으로 모니터링할 수 있게 해주는 커맨드 라인 인터페이스 도구입니다. 이 도구는 Kickbacks.ai에서 공식적으로 운영하는 도구는 아니지만, 사용자의 편의를 돕는 독립적인 동반 도구로서 역할을 수행합니다.

주요 목적은 사용자가 브라우저를 열지 않고도 **실시간 수익(Live Earnings)**과 **광고 기록(Ad History)**을 확인하는 것입니다. 특히 macOS 환경에 최적화되어 있으며, Apple의 서명 및 공증을 거쳐 보안성이 검증되었습니다. 사용자는 CLI 버전뿐만 아니라 macOS 메뉴바에서 간편하게 정보를 확인할 수 있는 메뉴바 앱 형태의 Kickbacks Bar도 선택하여 사용할 수 있습니다.

---

Kickbacks CLI의 주요 기능 (Features)

Kickbacks CLI는 개발자와 파워 유저를 위해 다음과 같은 풍부한 기능을 제공합니다.

1. 실시간 수익 및 상태 모니터링

터미널 내에서 현재의 Kickbacks.ai 상태와 오늘 벌어들인 수익, 그리고 전체 수익을 즉각적으로 확인할 수 있습니다. 데이터는 로컬에 저장된 정보를 바탕으로 안전하게 처리됩니다.

2. 광고 기록 및 일간 차트

단순한 수치 확인을 넘어, 어떤 광고가 노출되었는지에 대한 기록과 일일 수익 변화를 보여주는 차트 기능을 제공합니다. 이를 통해 수익 추이를 한눈에 파악할 수 있습니다.

3. Kickbacks Bar (메뉴바 앱)

명령어 입력보다 클릭을 선호하는 사용자를 위해 macOS 메뉴바 앱인 Kickbacks Bar를 제공합니다. 메뉴바에서 오늘 수익과 누적 수익을 상시 확인할 수 있으며, 단 한 번의 클릭으로 상세한 CLI 정보(수익, 광고 내역, 차트 등)에 접근할 수 있습니다.

4. 로컬 우선 및 안전한 설계

• 투명성: 숨겨진 동작 없이 모든 프로세스가 로컬에서 이루어집니다.
• 보안: Apple에 의해 서명 및 공증되었으며, 사용자의 코드를 읽거나 개인적인 프롬프트 및 답변에 접근하지 않습니다.
• 읽기 전용: 수익 데이터를 읽기만 할 뿐, 돈을 이체하거나 광고를 직접 클릭하는 등의 동작은 일절 수행하지 않습니다.

---

Kickbacks CLI 설치 및 사용법 (How to Use)

Kickbacks CLI를 설치하고 설정하는 과정은 매우 간단하며, macOS 사용자라면 누구나 쉽게 시작할 수 있습니다.

설치 요구 사항

• OS: macOS 13 이상
• 필수 구성 요소: python3 및 openssl (macOS에 기본 내장되어 있거나 Apple의 Command Line Tools를 통해 설치 가능)

설치 방법

방법 1: 단일 라인 설치 (curl 사용)

터미널에서 다음 명령어를 실행하여 즉시 설치할 수 있습니다.

curl -fsSL https://gabeperez.github.io/kickback-cli/install.sh | bash

방법 2: Homebrew를 통한 설치

Homebrew 사용자라면 다음 명령어를 통해 CLI를 설치할 수 있습니다.

brew install gabeperez/kickback/kickback

방법 3: Kickbacks Bar (메뉴바 앱) 설치

메뉴바 앱과 CLI를 동시에 설치하려면 다음 캐스크(Cask) 명령어를 사용하세요.

brew install --cask gabeperez/kickback/kickbacks-bar

초기 설정 방법

설치가 완료된 후 다음 명령어를 통해 Kickbacks.ai 계정과 연동할 수 있습니다.

1. 확장 프로그램 설치: kickback setup 명령어로 필요한 확장을 설치합니다.
2. 로그인: kickback login 명령어를 실행하여 계정에 로그인합니다.
3. 상태 점검: kickback doctor를 실행하여 모든 설정과 연결 상태가 정상인지 라이브로 확인합니다.

---

주요 활용 사례 (Use Case)

• 개발자 워크플로우 통합: 코딩 작업 중 터미널을 떠나지 않고도 kickback 명령어를 실행하여 실시간 수익을 확인하고 싶을 때.
• 수익 자동 기록: sampler 기능을 활성화하여 배경에서 60초마다 광고 로테이션과 수익 변화를 기록하고, 나중에 일간 차트로 분석하고 싶을 때.
• 시스템 알림 활용: 매일 발생한 수익에 대해 macOS 시스템 알림을 받고 싶을 때 (설정에서 notifications 활성화 필요).
• 오프라인 상태 확인: 네트워크 연결이 끊긴 상태에서도 로컬에 저장된 마지막 상태와 광고 데이터를 확인하고 싶을 때.

---

보안 및 데이터 무결성 (Safe by Default)

Kickbacks CLI는 사용자의 프라이버시를 최우선으로 생각합니다.

• 데이터 전송: 오직 사용자의 토큰과 Claude Code 버전 정보만이 Kickbacks의 공식 백엔드로 전송됩니다. 도구 개발자나 제3자에게는 어떠한 데이터도 전송되지 않습니다.
• 분석 도구 부재: 사용자 추적을 위한 분석 도구나 텔레메트리(Telemetry)가 포함되어 있지 않습니다.
• 구성 설정: 모든 설정은 ~/.config/kickback/config.json에서 수동으로 수정할 수 있습니다.

안전 기본값: 모든 쓰기 관련 기능(네트워크 연결, 샘플러, 알림 등)은 사용자가 직접 활성화하기 전까지는 꺼져 있거나 안전한 기본값으로 설정되어 있습니다.

| 기능 | 기본값 | 설명 | | :--- | :--- | :--- | | network | on | 수익 확인을 위해 Kickbacks 백엔드에 접속 | | sampler | off | 배경에서 광고 로테이션 및 수익 기록 | | notifications | off | 일일 수익에 대한 macOS 알림 발송 | | token_refresh | off | 에디터가 닫혀 있을 때 만료되는 토큰 갱신 |

---

자주 묻는 질문 (FAQ)

Q: 수익 데이터가 실제와 약간 다른 것 같습니다. 왜 그런가요? A: Kickbacks 백엔드는 누적 수익(전체/오늘)만 제공하며 광고 단가(CPM)나 노출당 비용은 제공하지 않습니다. 따라서 Kickbacks CLI는 표시되는 광고와 수익 변화를 대조하여 데이터를 추정합니다. 이는 정확한 광고주 집행 비용이 아닌 사용자의 예상 수익 점유율을 나타내며, 앱 내에서도 '근사치'로 표시됩니다.

Q: 에디터를 닫았을 때 수익 확인이 안 됩니다. A: 토큰이 만료되었거나 로그아웃된 경우 에디터를 다시 열어야 할 수 있습니다. 설정을 통해 token_refresh 기능을 켜면 에디터가 닫혀 있어도 토큰을 갱신하도록 시도할 수 있습니다.

Q: 어떤 환경에서 실행되나요? A: macOS 13 이상이 필요하며, Python 3와 OpenSSL 환경이 갖춰져 있어야 합니다. 설치 시 Apple의 무료 Command Line Tools 설치를 권장하는 팝업이 뜰 수 있습니다.

Q: 프로그램이 업데이트되면 어떻게 되나요? A: Kickbacks CLI는 Kickbacks.ai의 공식 확장이 업데이트되더라도 안정적으로 작동하도록 설계되었습니다. 형식이 바뀌더라도 크래시 없이 "unavailable(사용 불가)" 메시지를 표시하며 안전하게 대처합니다.