Kickbacks CLI

Kickbacks CLI: Monitorea tus Ganancias de Kickbacks.ai desde la Terminal de macOS

En el ecosistema de herramientas para desarrolladores, la eficiencia es clave. Kickbacks CLI surge como una solución robusta y transparente para todos los usuarios de Kickbacks.ai que desean mantener un control total sobre su estado, ganancias en vivo e historial de anuncios sin necesidad de abandonar su entorno de trabajo principal: la terminal. Esta herramienta complementaria independiente ha sido diseñada con un enfoque "local-first", garantizando que la privacidad y la seguridad sean la prioridad número uno.

¿Qué es Kickbacks CLI?

Kickbacks CLI es una interfaz de línea de comandos (CLI) y una aplicación para la barra de menú de macOS que funciona como un compañero esencial para la extensión oficial de Kickbacks.ai. Su función principal es permitirte ver tu estado actual, las ganancias acumuladas durante el día, los ingresos totales de por vida y el historial detallado de anuncios directamente desde tu terminal de macOS.

Al ser una herramienta independiente y no operada directamente por Kickbacks.ai, ofrece una capa adicional de visualización y control. Es importante destacar que Kickbacks CLI es una herramienta segura por defecto, firmada y notarizada por Apple, lo que asegura su integridad dentro del sistema operativo macOS 13 o versiones superiores.

Características Principales de Kickbacks CLI

El uso de Kickbacks CLI aporta una serie de funcionalidades avanzadas diseñadas para el desarrollador moderno que valora la transparencia y la rapidez:

• Visualización en Tiempo Real: Consulta tus ganancias "Live Today" y "Lifetime" de manera instantánea.
• Historial de Anuncios: Accede a un registro detallado de las rotaciones de anuncios directamente en tu disco local.
• Gráficos Diarios: Genera reportes visuales rápidos de tu actividad y rendimiento diario.
• Aplicación de Barra de Menú (Kickbacks Bar): Si prefieres un clic a un comando, la aplicación para la barra de menú mantiene tus estadísticas visibles en todo momento y pone a tu disposición toda la potencia de la CLI con un solo clic.
• Enfoque Local-First: Toda la información relevante se almacena y lee localmente en tu máquina. La herramienta respeta tu privacidad y no oculta procesos en segundo plano.
• Seguridad por Defecto: Las funciones de escritura están desactivadas inicialmente, permitiendo que la herramienta funcione de modo "solo lectura" hasta que decidas activar características adicionales.

Cómo Instalar y Usar Kickbacks CLI

La instalación de Kickbacks CLI es sencilla y ofrece múltiples métodos para adaptarse a tus preferencias de gestión de paquetes en macOS.

Requisitos Previos

Para que la herramienta funcione correctamente, tu sistema debe contar con:

1. macOS 13 o superior.
2. Python 3: Generalmente incluido en las Command Line Tools de Apple.
3. OpenSSL: Viene preinstalado en macOS.

Métodos de Instalación

1. Instalación mediante Homebrew

Si utilizas Homebrew, puedes instalar tanto la aplicación de la barra de menú como la CLI con un solo comando:

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

Si solo deseas la herramienta de línea de comandos, utiliza:

brew install gabeperez/kickback/kickback

2. Instalación mediante Script de una Línea

Puedes ejecutar el instalador oficial basado en Bash:

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

Configuración Inicial (Setup)

Una vez instalada, debes vincular la herramienta con tu cuenta de Kickbacks.ai:

• Configuración de la extensión: Ejecuta kickback setup para instalar la extensión necesaria.
• Inicio de sesión: Utiliza kickback login para autenticarte y sincronizar tus datos.

Comandos Útiles

• kickback about: Muestra información generada por la herramienta sobre su estado actual.
• kickback config: Permite ver y editar los ajustes (toggles) para activar o desactivar funciones.
• kickback doctor: Realiza una comprobación en vivo de la conexión, el token y el estado del sistema para solucionar problemas.

Casos de Uso

Kickbacks CLI es ideal para diversos perfiles de usuario dentro del ecosistema de desarrollo:

• Desarrolladores Minimalistas: Aquellos que prefieren monitorear sus ingresos pasivos sin abrir navegadores o aplicaciones pesadas, integrando el flujo de trabajo en sus scripts de terminal.
• Usuarios Preocupados por la Privacidad: Gracias a su política de "no telemetría", los usuarios pueden estar seguros de que sus prompts, códigos y datos personales nunca se envían a terceros ni al autor de la herramienta.
• Análisis de Rendimiento: Mediante el uso del comando de historial y gráficos, los usuarios pueden entender mejor cómo fluctúan sus ganancias a lo largo del día.

Seguridad y Privacidad: Safe by Default

La arquitectura de Kickbacks CLI ha sido construida para ser lo más transparente posible. Aquí te detallamos qué hace y qué no hace la herramienta:

Lo que la herramienta lee y envía

• Lectura Local: Accede a los archivos de la extensión (cli-ad.json, debug.log), configuraciones de editor (~/.claude/settings.json) y el llavero de macOS (Keychain) para obtener el token de acceso cifrado.
• Comunicación de Red: Solo envía tu token y la versión de Claude Code directamente al backend oficial de Kickbacks.ai. No existe un servidor intermediario.

Lo que NUNCA hace

✗ No lee tu código: Tus prompts y compleciones de código permanecen privados. ✗ No mueve dinero: Es una herramienta de consulta, no puede realizar transacciones ni hacer clic en anuncios. ✗ No envía telemetría: No hay análisis de uso ni rastreo hacia el autor de la herramienta.

Preguntas Frecuentes (FAQ)

¿Es Kickbacks CLI una herramienta oficial? No, es una herramienta complementaria independiente potenciada por Kickbacks.ai, pero no es operada directamente por ellos.

¿Por qué las ganancias por día son aproximadas? El backend de Kickbacks.ai solo expone ganancias agregadas (hoy y total). Por lo tanto, los totales por día y por anuncio en la CLI se derivan de los cambios detectados mientras el anuncio estaba visible. Son estimaciones precisas de tu parte, no del gasto total del anunciante.

¿Qué sucede si la extensión oficial se actualiza? Kickbacks CLI está diseñada para degradarse con elegancia. Si el formato del token cambia, es posible que las ganancias aparezcan como "no disponibles", pero el estado local en disco seguirá funcionando y la herramienta no se cerrará inesperadamente.

¿Puedo usarlo sin conexión a internet? Sí, puedes desactivar la función de red mediante kickback config para ver únicamente el estado almacenado localmente en tu disco sin contactar al backend.