Kickbacks CLI

Kickbacks CLI : Suivez vos revenus Kickbacks.ai en direct depuis votre terminal

Optimiser la gestion de ses revenus passifs nécessite des outils à la fois puissants, rapides et transparents. Pour les utilisateurs de Kickbacks.ai, l'outil Kickbacks CLI s'impose comme le compagnon idéal. Conçu pour s'intégrer parfaitement à votre flux de travail de développeur, ce programme en ligne de commande vous permet de consulter votre statut, vos gains en direct et l'historique de vos publicités sans jamais quitter votre environnement de travail habituel.

Que vous soyez un utilisateur intensif de la ligne de commande ou que vous préfériez une interface discrète dans votre barre de menus, Kickbacks CLI offre une solution robuste, locale et sécurisée par défaut.

Qu'est-ce que Kickbacks CLI ?

Kickbacks CLI est un outil compagnon indépendant développé pour fonctionner avec l'extension Kickbacks.ai. Contrairement à de nombreux outils tiers, il adopte une approche "local-first", ce qui signifie que l'essentiel du traitement et du stockage des données s'effectue directement sur votre machine.

L'objectif principal de Kickbacks CLI est d'offrir une visibilité immédiate sur vos performances financières au sein de l'écosystème Kickbacks.ai. Il permet de voir vos revenus cumulés à vie (lifetime earnings), vos gains du jour et l'historique complet des publicités diffusées. Signé et notarisé par Apple, cet outil garantit une installation sûre sur macOS 13 et versions ultérieures.

Caractéristiques principales de Kickbacks CLI

Kickbacks CLI ne se contente pas d'afficher des chiffres ; il propose une suite de fonctionnalités conçues pour la transparence et le contrôle.

1. Suivi des gains en temps réel

Grâce à Kickbacks CLI, vous avez accès à vos statistiques financières instantanément. L'outil interroge le backend de Kickbacks.ai pour récupérer vos revenus totaux et quotidiens. Ces informations sont présentées de manière claire, vous permettant de suivre l'évolution de vos gains au fil de la journée.

2. Historique publicitaire et graphiques quotidiens

L'une des forces de Kickbacks CLI est sa capacité à archiver et à présenter l'historique des rotations publicitaires. Grâce à la fonction sampler (activable en option), l'outil peut journaliser les publicités diffusées toutes les 60 secondes, créant ainsi des graphiques quotidiens détaillés pour mieux comprendre la provenance de vos revenus.

3. Kickbacks Bar : L'alternative visuelle

Pour ceux qui préfèrent un simple clic à une commande textuelle, le pack inclut Kickbacks Bar. Cette application pour la barre de menus macOS affiche vos gains en direct en haut de votre écran et permet d'accéder à l'ensemble des fonctionnalités de la version CLI (historique, graphiques, statut) en un clic.

4. Transparence et Sécurité "Safe by Default"

La sécurité est au cœur de Kickbacks CLI.

• Lecture locale uniquement : L'outil accède aux fichiers de votre extension, à votre trousseau macOS (Keychain) pour le jeton d'accès, et aux paramètres de votre éditeur (comme Claude Code) pour s'assurer que tout est synchronisé.
• Aucune donnée sensible partagée : Seuls votre jeton et la version de votre logiciel sont envoyés aux serveurs officiels de Kickbacks.ai.
• Zéro télémétrie : L'auteur de l'outil ne reçoit aucune donnée analytique.

Comment installer et utiliser Kickbacks CLI

L'installation de Kickbacks CLI est simplifiée pour les utilisateurs de macOS. Il nécessite Python 3 et OpenSSL, deux composants généralement déjà présents ou faciles à obtenir via les outils de ligne de commande d'Apple.

Méthodes d'installation

Vous avez deux options principales pour installer l'outil :

Option A : Via Homebrew (Recommandé)

Si vous utilisez le gestionnaire de paquets Homebrew, l'installation est immédiate :

brew install gabeperez/kickback/kickback

Si vous souhaitez installer à la fois l'application de barre de menus et le CLI :

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

Option B : Installation directe via Curl

Vous pouvez également utiliser un script d'installation en une seule ligne :

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

Configuration initiale

Une fois installé, vous devez lier l'outil à votre compte Kickbacks.ai :

1. Configuration : Utilisez kickback setup pour installer l'extension nécessaire.
2. Connexion : Tapez kickback login pour vous connecter.
3. Vérification : La commande kickback doctor permet de vérifier que tout fonctionne correctement (statut du jeton, connexion au backend, accès au trousseau).

Commandes de configuration

Vous pouvez personnaliser le comportement de Kickbacks CLI via la commande kickback config. Voici les options disponibles :

• network : Activé par défaut pour contacter le backend.
• sampler : Désactivé par défaut. Activez-le pour journaliser l'historique des publicités.
• notifications : Désactivé par défaut. Activez-le pour recevoir une notification quotidienne de vos gains.
• token_refresh : Permet de rafraîchir le jeton même si l'éditeur est fermé.

Toute la configuration est également modifiable manuellement dans le fichier ~/.config/kickback/config.json.

Cas d'utilisation (Use Case)

Kickbacks CLI s'adresse principalement aux profils suivants :

• Développeurs et Power Users : Ceux qui passent la majeure partie de leur temps dans un terminal et souhaitent surveiller leurs revenus passifs sans changer de contexte applicatif.
• Utilisateurs soucieux de la vie privée : Grâce à son approche locale, l'outil permet d'auditer exactement ce qui est lu et envoyé. Vous pouvez inspecter le script source avant l'installation.
• Analystes de revenus : En activant le sampler, les utilisateurs peuvent obtenir des données historiques plus fines sur la rotation des publicités et l'efficacité de leur temps de session.

FAQ (Foire aux questions)

Pourquoi les gains par publicité sont-ils approximatifs ?

Le backend de Kickbacks.ai n'expose que les revenus agrégés (aujourd'hui et total). Kickbacks CLI calcule les montants par publicité en attribuant les changements de revenus à la publicité actuellement affichée. C'est une estimation de votre part, et non une donnée brute du coût annonceur.

Kickbacks CLI peut-il lire mon code ?

Non. Kickbacks CLI n'accède jamais à votre code source, à vos prompts ou à vos complétions. Il se concentre exclusivement sur les fichiers liés à l'extension Kickbacks et aux données de revenus.

Que se passe-t-il si l'extension officielle est mise à jour ?

L'outil est conçu pour se dégrader gracieusement. Si le format du jeton change ou si le backend est modifié, Kickbacks CLI affichera simplement que les gains sont "indisponibles" au lieu de planter. Vous pourrez alors mettre à jour votre configuration ou l'outil lui-même.

Est-il possible de l'utiliser hors ligne ?

Oui, en désactivant l'option network dans la configuration. Vous pourrez toujours voir le statut sur le disque et l'historique local, bien que les gains en direct ne soient plus mis à jour depuis le serveur.

Note importante : Kickbacks CLI est un outil compagnon indépendant et n'est pas opéré directement par Kickbacks.ai. Il est toutefois conçu pour être totalement compatible avec leurs services officiels.