Configuratie

Alles kan worden geconfigureerd via het Instellingenpaneel — open het met Vibes to Bucks: Cost Tracking & Billing Setup in de Cursor command palette. Geen YAML-bewerking nodig.

1. Verbind je facturatiesoftware (Pro)

Onder Facturatiesoftware, kies Moneybird of Harvest.

Voer je API-token in en klik op Verbinding testen. Zodra verbonden, worden de dropdowns Administratie en Gebruiker automatisch gevuld vanuit je account. Selecteer de juiste administratie en gebruiker — tijdregistraties worden onder deze gebruiker aangemaakt.

Je token wordt veilig opgeslagen in de SecretStorage van VS Code. Het wordt nooit naar een configuratiebestand of schijf geschreven.

Je Moneybird API-token verkrijgen

1. Ga in Moneybird naar Instellingen (tandwielicoon, linksonder)
2. Klik op Externe en AI-verbindingen
3. Onder Externe applicaties, klik op API-token aanmaken
4. Geef het token een naam (bijv. Vibes to Bucks), bevestig en kopieer het token
5. Plak het in het API-tokenveld in het Vibes to Bucks Instellingenpaneel

Je Harvest-token verkrijgen

1. Ga in Harvest naar Developers → Personal Access Tokens
2. Klik op Create new personal access token, geef het een naam en kopieer het token
3. Je hebt ook je Account ID nodig — te zien op dezelfde pagina naast je accountnaam
4. Plak beide in het Vibes to Bucks Instellingenpaneel

2. Voeg facturatieregels toe

Facturatieregels vertellen de extensie naar welke klant en project AI-kosten moeten worden toegewezen. Open het Instellingenpaneel en scroll naar Facturatieregel toevoegen.

Wat wil je bijhouden?

• Repository — matcht op git remote. Gebruik dit voor de meeste projecten. De extensie detecteert de remote automatisch wanneer je een werkruimte open hebt.
• Map — matcht op mappad. Gebruik dit voor projecten zonder git remote, of om een lokale map aan een specifieke tak van een multiklantenrepo te koppelen.

Regelvelden

Klik op Regel opslaan als je klaar bent.

Meerdere klanten op één repo

Als verschillende takken van dezelfde repo bij verschillende klanten horen, vink Meerdere klanten op deze repo aan en sla op. De regel toont dan een tak-icoon in de Facturatieregels tabel — klik erop om Takregels te openen.

Elke takregel voegt een patroon toe (exacte taknaam zoals main, enkele wildcard zoals client-a/*, of recursief zoals feature/**) en heeft zijn eigen contact, project, tarief, factureringsmodus en budgetinstellingen.

Regels worden van boven naar beneden gematcht — de eerste match wint.

3. Niet-toegewezen kosten

De sectie Niet-toegewezen kosten (ook bereikbaar via Vibes to Bucks: Show Unassigned Costs) toont repos met bijgehouden AI-kosten die nog niet aan een facturatieregel zijn gekoppeld. Klik op Toewijzen naast een repo om het formulier Facturatieregel toevoegen te openen met de repository al ingevuld.

4. Instellingen

Klik op Instellingen opslaan na het aanbrengen van wijzigingen.

5. AI Samenvatting (Pro)

Bij synchronisatie kan de extensie betekenisvolle tijdregistratiebeschrijvingen genereren van je recente git commits met behulp van een AI-model.

Vereisten

• Git moet lokaal geïnstalleerd zijn. De extensie voert git log uit om commitberichten op te halen voor AI-samenvatting.
• SSH remote werkruimtes: SSH-sleutelgebaseerde authenticatie (wachtwoordloos) is vereist. Git moet op de remote machine geïnstalleerd zijn. De extensie voert automatisch ssh <host> "git log ..." uit wanneer het een SSH-werkruimte detecteert.

Geavanceerd: YAML-referentie

Het Instellingenpaneel schrijft naar ~/.vibes-to-bucks/config.yaml. Je kunt dit bestand direct bewerken als alternatief — het paneel en YAML zijn volledig uitwisselbaar.

Volledig voorbeeld

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

Remote normalisatie

Git remotes worden genormaliseerd voordat ze worden gematcht. Al deze lossen op naar github.com/acme/website:

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

Schrijf repo-waarden als host/org/repo — geen protocol, geen .git.

Moneybird ID’s vinden

• Administratie-ID: zichtbaar in de URL — moneybird.com/{id}/...
• Contact-ID: open een contact, ID staat in de URL
• Project-ID: Instellingen → Projecten → klik op een project → ID in URL
• Gebruikers-ID: Instellingen → Gebruikers → jouw gebruiker → ID in URL