Configuration

Tout peut être configuré via le panneau de paramètres — ouvre-le avec Vibes to Bucks: Cost Tracking & Billing Setup dans la palette de commandes de Cursor. Pas besoin d’éditer du YAML.

1. Connecte ton logiciel de facturation (Pro)

Sous Logiciel de facturation, choisis Moneybird ou Harvest.

Entre ton API Token et clique sur Test Connection. Une fois connecté, les listes déroulantes Administration et User se remplissent automatiquement à partir de ton compte. Sélectionne la bonne administration et utilisateur — les entrées de temps seront créées sous cet utilisateur.

Ton token est stocké en toute sécurité dans le SecretStorage de VS Code. Il n’est jamais écrit dans un fichier de config ou sur le disque.

Obtenir ton token API Moneybird

1. Dans Moneybird, va dans Paramètres (icône d’engrenage, en bas à gauche)
2. Clique sur Connexions externes et IA
3. Sous Applications externes, clique sur Créer un token API
4. Donne un nom au token (par ex. Vibes to Bucks), confirme et copie le token
5. Colle-le dans le champ API Token du panneau de paramètres de Vibes to Bucks

Obtenir ton token Harvest

1. Dans Harvest, va dans Developers → Personal Access Tokens
2. Clique sur Create new personal access token, donne-lui un nom et copie le token
3. Tu as aussi besoin de ton Account ID — visible sur la même page à côté de ton nom de compte
4. Colle les deux dans le panneau de paramètres de Vibes to Bucks

2. Ajouter des règles de facturation

Les règles de facturation indiquent à l’extension à quel client et projet attribuer les coûts IA. Ouvre le panneau de paramètres et fais défiler jusqu’à Add Billing Rule.

Que veux-tu suivre ?

• Repository — correspond par remote git. Utilise cela pour la plupart des projets. L’extension détecte automatiquement le remote lorsque tu as un espace de travail ouvert.
• Folder — correspond par chemin de dossier. Utilise cela pour les projets sans remote git, ou pour lier un dossier local à une branche spécifique d’un dépôt multi-client.

Champs de la règle

Clique sur Save Rule quand c’est terminé.

Plusieurs clients sur un même dépôt

Si différentes branches du même dépôt appartiennent à différents clients, coche Multiple clients on this repo et enregistre. La règle affiche alors une icône de branche dans le tableau des règles de facturation — clique dessus pour ouvrir Branch Rules.

Chaque règle de branche ajoute un pattern (nom exact de la branche comme main, joker simple comme client-a/*, ou récursif comme feature/**) et son propre contact, projet, tarif, mode de facturation et paramètres de budget.

Les règles sont appliquées de haut en bas — la première correspondance l’emporte.

3. Coûts non assignés

La section Unassigned Costs (également accessible via Vibes to Bucks: Show Unassigned Costs) liste les dépôts avec des coûts IA suivis qui ne correspondent à aucune règle de facturation pour le moment. Clique sur Assign à côté d’un dépôt pour ouvrir le formulaire Add Billing Rule avec le dépôt pré-rempli.

4. Paramètres

Clique sur Save Settings après avoir apporté des modifications.

5. Résumé IA (Pro)

Lors de la synchronisation, l’extension peut générer des descriptions d’entrées de temps significatives à partir de tes récents commits git en utilisant un modèle IA.

Prérequis

• Git doit être installé localement. L’extension exécute git log pour récupérer les messages de commit pour le résumé IA.
• Espaces de travail distants SSH : l’authentification par clé SSH (sans mot de passe) est requise. Git doit être installé sur la machine distante. L’extension exécute automatiquement ssh <host> "git log ..." lorsqu’elle détecte un espace de travail SSH.

Avancé : Référence YAML

Le panneau de paramètres écrit dans ~/.vibes-to-bucks/config.yaml. Tu peux éditer ce fichier directement comme alternative — le panneau et le YAML sont entièrement interchangeables.

Exemple complet

destination: moneybird

moneybird:
  administration_id: "123456789"
  user_id: "987654321"

polling:
  interval_minutes: 5
  sync_schedule: daily

fx:
  source: ecb
  fallback_rate: 0.92

mappings:
  # Single-client repo
  - repo: github.com/acme/website
    contact_id: "100"
    billing:
      mode: multiplier
      project_id: "200"
      hourly_rate: 120
      multiplier: 5
    budget:
      max_ai_cost_per_week: 50

  # Multi-client repo — different branches → different clients
  - repo: github.com/org/platform
    multiclient: true
    branches:
      - pattern: "client-a/*"
        contact_id: "300"
        billing:
          mode: multiplier
          project_id: "400"
          hourly_rate: 100
          multiplier: 5
      - pattern: dev
        contact_id: "600"
        billing:
          mode: passthrough
          project_id: "700"
          hourly_rate: 0

  # Folder fallback
  - folder: /home/user/experiments
    contact_id: "800"
    billing:
      mode: passthrough
      project_id: "900"
      hourly_rate: 100

Normalisation des remotes

Les remotes Git sont normalisés avant la correspondance. Tous ceux-ci se résolvent en github.com/acme/website :

• [email protected]:acme/website.git
• https://github.com/acme/website.git
• ssh://[email protected]/acme/website.git

Écris les valeurs repo comme host/org/repo — sans protocole, sans .git.

Trouver les IDs Moneybird

• Administration ID : visible dans l’URL — moneybird.com/{id}/...
• Contact ID : ouvre un contact, l’ID est dans l’URL
• Project ID : Paramètres → Projets → clique sur un projet → ID dans l’URL
• User ID : Paramètres → Utilisateurs → ton utilisateur → ID dans l’URL