Wie die Abrechnung funktioniert

Vibes to Bucks verfolgt deine Cursor AI-Token-Kosten und wandelt sie in abrechenbare Stunden in deiner Zeiterfassungssoftware (Moneybird oder Harvest) um. Die Umrechnung basiert auf deinem Stundensatz – die Erweiterung berechnet, wie viele Stunden deiner Zeit die AI-Kosten darstellen, und erstellt einen Zeiteintrag für diesen Betrag.

Pro Kunden-Zuordnung steuerst du drei Dinge:

AI-Kosten multiplizieren (empfohlen)

Verwende dies, wenn du AI-unterstützte Arbeit mit einer Gewinnmarge abrechnen möchtest. Du setzt einen Kosten-zu-Gewinn-Multiplikator, der die rohen AI-Kosten skaliert, bevor sie in Stunden umgewandelt werden. Dies erfasst den echten Wert, den du lieferst – Prompt-Erstellung, Überprüfung und Iteration der Ergebnisse, Integration des Ergebnisses und Verantwortung für das Endprodukt.

Die Berechnung:

cost_eur = cost_usd × multiplier × fx_rate
hours    = cost_eur / hourly_rate

Beispiel: €10 AI-Kosten, Multiplikator 5, Stundensatz €120/h:

cost_eur = €10 × 5 = €50
hours    = €50 / €120 = 0.42h (≈ 25 minutes billed)

Ein Multiplikator von 5 bedeutet, dass jeder €1 AI-Ausgabe zu €5 abrechenbarem Umsatz wird – eine Marge, die die Expertise und Zeit widerspiegelt, die du in die AI-Ergebnisse investierst. Starte bei 5 und passe an, um deine Kundenvereinbarungen zu erfüllen.

Durchreichen zum Nennwert

Verwende dies für Kostenrückgewinnungsabrechnung – die rohen AI-Kosten werden dem Kunden zum Nennwert weitergegeben, umgerechnet in Stunden zu deinem Stundensatz. Keine Marge wird hinzugefügt.

Die Berechnung:

cost_eur = cost_usd × fx_rate
hours    = cost_eur / hourly_rate

Beispiel: $12.00 AI-Kosten, EUR/USD-Kurs 0.92, Stundensatz €120/h:

cost_eur = $12.00 × 0.92 = €11.04
hours    = €11.04 / €120  = 0.092h (≈ 6 minutes billed)

Nicht abrechenbar

Deaktiviere Abrechenbar bei einer Zuordnung, um AI-Kosten für diesen Kunden oder dieses Projekt zu verfolgen, ohne einen Zeiteintrag zu erstellen. Die Kosten erscheinen in deinem Dashboard, sodass du die Ausgaben sehen kannst, aber nichts wird mit Moneybird oder Harvest synchronisiert. Nützlich für interne Projekte, F&E oder jede Arbeit, bei der du die AI-Kosten selbst trägst.

Wechselkurse

Die USD→EUR-Umrechnung nutzt die Frankfurter API, die täglich um 16:00 CET die Referenzkurse der Europäischen Zentralbank bereitstellt. Kurse werden lokal zwischengespeichert, um überflüssige API-Aufrufe zu vermeiden. Wenn die API nicht erreichbar ist, greift die Erweiterung auf den fallback_rate aus deiner Konfiguration zurück.

Für Nachträge holt die Erweiterung den historischen Kurs für jeden spezifischen Tag, sodass du auch für vergangene Daten genaue Umrechnungen erhältst.

Rundung und Mindestwerte

Zeiteinträge werden als Start-/Endzeitstempel gespeichert. Die Erweiterung wandelt Stunden in Minuten um und rundet auf die nächste volle Minute, mit einem Minimum von 1 Minute:

Alle Einträge beginnen um 09:00 UTC. Die Endzeit wird aus der gerundeten Dauer berechnet. Diese Zeitstempel sind eine API-Anforderung und spiegeln nicht die tatsächlichen Arbeitszeiten wider.

Ein Eintrag pro Kunde pro Projekt pro Tag

Die Synchronisierungs-Engine erzeugt höchstens einen Zeiteintrag pro Kunde pro Projekt pro Tag. Wenn später am selben Tag weitere Ereignisse eintreffen, aktualisiert die nächste Synchronisierung den bestehenden Eintrag, anstatt einen neuen zu erstellen. Das hält dein Zeiterfassungsblatt sauber und vermeidet fragmentierte Einträge.

Idempotente Synchronisierung

Bevor ein Eintrag erstellt wird, prüft die Erweiterung, ob bereits einer für die gleiche (Tag, Kontakt, Projekt)-Kombination existiert:

Zweimal hintereinander “Jetzt synchronisieren” ausführen erzeugt keine Duplikate.

Wöchentliches Budgetlimit

Setze ein wöchentliches AI-Kostenlimit pro Zuordnung (Pro). Die Erweiterung verfolgt die Ausgaben pro Repo und sendet Cursor-Benachrichtigungen bei Meilensteinen: 25%, 50%, 75%, 85%, 95% als Info-Alarme, eskalierend zu einer Warnung bei 100% und alle 10% darüber hinaus. Jeder Meilenstein wird einmal pro Woche pro Repo ausgelöst.

Dies ist ein weiches Limit – es blockiert nie die AI-Nutzung, sondern informiert dich, bevor du darüber hinausgehst. Der Budgetstatus ist auch im Nutzungs-Dashboard sichtbar, mit Anzeigen, die Ausgaben im Vergleich zum Limit zeigen.