कॉन्फ़िगरेशन

सब कुछ Settings panel के माध्यम से कॉन्फ़िगर किया जा सकता है — इसे Cursor command palette में Vibes to Bucks: Cost Tracking & Billing Setup के साथ खोलें। YAML संपादन की आवश्यकता नहीं है।

1. अपने बिलिंग सॉफ़्टवेयर को कनेक्ट करें (Pro)

Billing software के अंतर्गत, Moneybird या Harvest चुनें।

अपना API Token दर्ज करें और Test Connection पर क्लिक करें। एक बार कनेक्ट हो जाने पर, Administration और User ड्रॉपडाउन आपके खाते से स्वचालित रूप से भर जाते हैं। सही प्रशासन और उपयोगकर्ता का चयन करें — समय प्रविष्टियाँ इस उपयोगकर्ता के अंतर्गत बनाई जाएंगी।

आपका टोकन VS Code के SecretStorage में सुरक्षित रूप से संग्रहीत होता है। इसे कभी भी कॉन्फ़िग फाइल या डिस्क पर नहीं लिखा जाता है।

अपना Moneybird API टोकन प्राप्त करना

Moneybird में, Settings (गियर आइकन, नीचे-बाएँ) पर जाएँ
External and AI connections पर क्लिक करें
External applications के अंतर्गत, Create API token पर क्लिक करें
टोकन को एक नाम दें (जैसे Vibes to Bucks), पुष्टि करें, और टोकन को कॉपी करें
इसे Vibes to Bucks Settings panel में API Token फ़ील्ड में पेस्ट करें

अपना Harvest टोकन प्राप्त करना

Harvest में, Developers → Personal Access Tokens पर जाएँ
Create new personal access token पर क्लिक करें, इसे एक नाम दें, और टोकन को कॉपी करें
आपको अपना Account ID भी चाहिए — आपके खाते के नाम के बगल में उसी पृष्ठ पर दिखाया गया है
दोनों को Vibes to Bucks Settings panel में पेस्ट करें

2. बिलिंग नियम जोड़ें

बिलिंग नियम एक्सटेंशन को बताते हैं कि AI लागत को किस क्लाइंट और प्रोजेक्ट में असाइन करना है। Settings panel खोलें और Add Billing Rule तक स्क्रॉल करें।

आप क्या ट्रैक करना चाहते हैं?

Repository — git remote द्वारा मेल खाता है। अधिकांश प्रोजेक्ट्स के लिए इसका उपयोग करें। जब आपके पास एक वर्कस्पेस खुला होता है, तो एक्सटेंशन स्वचालित रूप से remote का पता लगाता है।
Folder — फ़ोल्डर पथ द्वारा मेल खाता है। उन प्रोजेक्ट्स के लिए उपयोग करें जिनके पास git remote नहीं है, या किसी स्थानीय फ़ोल्डर को multiclient repo की किसी विशिष्ट शाखा से लिंक करने के लिए।

नियम फ़ील्ड्स

फ़ील्ड	यह क्या करता है
Contact	Moneybird या Harvest में वह क्लाइंट जिसे यह नियम बिल करता है। खोजने के लिए टाइप करना शुरू करें।
Project	उस क्लाइंट के अंतर्गत प्रोजेक्ट। खोजने के लिए टाइप करना शुरू करें।
Hourly Rate (EUR)	इस क्लाइंट के लिए आपकी दर। AI लागत को बिल योग्य घंटों में बदलने के लिए उपयोग किया जाता है।
How to calculate billable time	Multiply AI cost — घंटों में बदलने से पहले आपके लाभ गुणक को लागू करता है। Pass through at face value — कच्ची लागत को क्लाइंट के पास भेजता है।
Cost to Profit Multiplier	केवल तब दिखाया जाता है जब multiply मोड चुना जाता है। डिफ़ॉल्ट 5 है (AI लागत के प्रत्येक €1 के लिए €5 बिल किया जाता है)।
Weekly budget cap	इस नियम के लिए प्रति सप्ताह अधिकतम AI लागत सेट करने के लिए चेक करें। एक्सटेंशन आपको 25%, 50%, 75%, 85%, 95% और जब आप सीमा पार करते हैं, तब अलर्ट करता है।
Billable	डिफ़ॉल्ट रूप से चेक किया गया। इस नियम के लिए लागतों को ट्रैक करने के लिए अनचेक करें बिना समय प्रविष्टि उत्पन्न किए — आंतरिक प्रोजेक्ट्स या अवशोषित ओवरहेड्स के लिए उपयोगी।

जब हो जाए तो Save Rule पर क्लिक करें।

एक repo पर कई क्लाइंट्स

यदि एक ही repo की विभिन्न शाखाएँ विभिन्न क्लाइंट्स से संबंधित हैं, तो Multiple clients on this repo चेक करें और सहेजें। फिर नियम बिलिंग नियम तालिका में एक शाखा आइकन दिखाता है — इसे खोलने के लिए Branch Rules पर क्लिक करें।

प्रत्येक शाखा नियम एक pattern जोड़ता है (सटीक शाखा नाम जैसे main, एकल वाइल्डकार्ड जैसे client-a/*, या पुनरावर्ती जैसे feature/**) और इसका अपना संपर्क, प्रोजेक्ट, दर, बिलिंग मोड, और बजट सेटिंग्स।

नियम ऊपर से नीचे मेल खाते हैं — पहला मेल जीतता है।

3. असाइन न की गई लागतें

Unassigned Costs अनुभाग (जिसे Vibes to Bucks: Show Unassigned Costs के माध्यम से भी पहुँचा जा सकता है) उन repos की सूची देता है जिनमें ट्रैक की गई AI लागतें हैं जो अभी तक किसी बिलिंग नियम से मेल नहीं खाती हैं। किसी repo के बगल में Assign पर क्लिक करें ताकि Add Billing Rule फॉर्म को पहले से भरे हुए repository के साथ खोला जा सके।

4. सेटिंग्स

सेटिंग	यह क्या करता है
Language	एक्सटेंशन के लिए UI भाषा। 15 भाषाएँ उपलब्ध हैं।
Check for new costs every (minutes)	कितनी बार एक्सटेंशन Cursor के लिए नए उपयोग की जाँच करता है। डिफ़ॉल्ट: 5।
Sync to billing software	Daily — दिन के अंत में स्वचालित रूप से सिंक करता है। Manual — जब आप सिंक करना चाहते हैं तो command palette से `Vibes to Bucks: Sync Now` चलाएँ।
Fallback exchange rate (USD → EUR)	जब लाइव ECB दर उपलब्ध नहीं होती है, तो इसका उपयोग किया जाता है। पैनल वर्तमान लाइव दर दिखाता है और आपको एक क्लिक में नवीनतम प्राप्त करने देता है।
Display Currency	EUR या USD। यह तय करता है कि डैशबोर्ड और स्टेटस बार में लागतें कैसे दिखाई जाएँगी।

परिवर्तन करने के बाद Save Settings पर क्लिक करें।

5. AI Summarization (Pro)

सिंक करते समय, एक्सटेंशन आपके हाल के git commits से AI मॉडल का उपयोग करके अर्थपूर्ण समय प्रविष्टि विवरण उत्पन्न कर सकता है।

फ़ील्ड	यह क्या करता है
AI provider	Anthropic या OpenAI।
Model	प्रीसेट से चुनें (जैसे Claude Haiku 4.5) या एक कस्टम मॉडल ID दर्ज करें।
API key	अपनी कुंजी दर्ज करें और Save Key पर क्लिक करें। SecretStorage में सुरक्षित रूप से संग्रहीत — कभी भी कॉन्फ़िग फाइलों में नहीं लिखा जाता है।

आवश्यकताएँ

Git को स्थानीय रूप से इंस्टॉल किया जाना चाहिए। एक्सटेंशन AI summarization के लिए commit संदेशों को प्राप्त करने के लिए git log चलाता है।
SSH remote workspaces: SSH कुंजी-आधारित प्रमाणीकरण (पासवर्ड रहित) आवश्यक है। Git को remote मशीन पर इंस्टॉल किया जाना चाहिए। एक्सटेंशन स्वचालित रूप से ssh <host> "git log ..." चलाता है जब यह एक SSH workspace का पता लगाता है।

उन्नत: YAML संदर्भ

Settings panel ~/.vibes-to-bucks/config.yaml में लिखता है। आप इस फ़ाइल को सीधे संपादित कर सकते हैं — पैनल और YAML पूरी तरह से विनिमेय हैं।

पूर्ण उदाहरण

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 normalization

Git remotes को मेल खाने से पहले सामान्यीकृत किया जाता है। ये सभी github.com/acme/website के रूप में हल होते हैं:

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

repo मानों को host/org/repo के रूप में लिखें — कोई प्रोटोकॉल नहीं, कोई .git नहीं।

Moneybird IDs ढूँढना

Administration ID: URL में दिखाई देता है — moneybird.com/{id}/...
Contact ID: एक संपर्क खोलें, ID URL में है
Project ID: Settings → Projects → एक प्रोजेक्ट पर क्लिक करें → ID URL में है
User ID: Settings → Users → आपका उपयोगकर्ता → ID URL में है