ترتیب

ہر چیز کو Settings panel کے ذریعے ترتیب دیا جا سکتا ہے — اسے Vibes to Bucks: Cost Tracking & Billing Setup کے ذریعے Cursor کمانڈ پیلیٹ میں کھولیں۔ YAML ایڈیٹنگ کی ضرورت نہیں۔

1. اپنے بلنگ سافٹ ویئر کو کنیکٹ کریں (Pro)

Billing software کے تحت، Moneybird یا Harvest کا انتخاب کریں۔

اپنا API Token درج کریں اور Test Connection پر کلک کریں۔ جب کنیکٹ ہو جائے تو، Administration اور User کے ڈراپ ڈاؤن خود بخود آپ کے اکاؤنٹ سے بھر جائیں گے۔ صحیح ایڈمنسٹریشن اور یوزر کا انتخاب کریں — وقت کے اندراجات اس یوزر کے تحت بنائے جائیں گے۔

آپ کا ٹوکن VS Code کے SecretStorage میں محفوظ طریقے سے اسٹور کیا جاتا ہے۔ یہ کبھی بھی کسی کنفیگ فائل یا ڈسک پر نہیں لکھا جاتا۔

اپنا Moneybird API ٹوکن حاصل کرنا

  1. Moneybird میں، Settings (گیئر آئیکن، نیچے بائیں) پر جائیں
  2. External and AI connections پر کلک کریں
  3. External applications کے تحت، Create API token پر کلک کریں
  4. ٹوکن کو ایک نام دیں (مثلاً Vibes to Bucks), تصدیق کریں، اور ٹوکن کو کاپی کریں
  5. اسے Vibes to Bucks Settings پینل میں API Token فیلڈ میں پیسٹ کریں

اپنا Harvest ٹوکن حاصل کرنا

  1. Harvest میں، Developers → Personal Access Tokens پر جائیں
  2. Create new personal access token پر کلک کریں، اسے ایک نام دیں، اور ٹوکن کو کاپی کریں
  3. آپ کو اپنا Account ID بھی چاہیے — جو آپ کے اکاؤنٹ کے نام کے ساتھ اسی صفحے پر دکھایا جاتا ہے
  4. دونوں کو Vibes to Bucks Settings پینل میں پیسٹ کریں

2. بلنگ قواعد شامل کریں

بلنگ قواعد ایکسٹینشن کو بتاتے ہیں کہ AI اخراجات کو کس کلائنٹ اور پروجیکٹ کے ساتھ منسلک کرنا ہے۔ Settings پینل کھولیں اور Add Billing Rule پر سکرول کریں۔

آپ کیا ٹریک کرنا چاہتے ہیں؟

قاعدہ کے فیلڈز

فیلڈ یہ کیا کرتا ہے
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 صرف اس وقت دکھایا جاتا ہے جب ملٹیپلی موڈ منتخب کیا گیا ہو۔ ڈیفالٹ 5 ہے (AI لاگت کے ہر €1 کے لیے €5 بل کیا جاتا ہے)۔
Weekly budget cap اس قاعدے کے لیے فی ہفتہ زیادہ سے زیادہ AI لاگت مقرر کرنے کے لیے چیک کریں۔ ایکسٹینشن آپ کو 25%, 50%, 75%, 85%, 95% پر اور جب آپ حد سے تجاوز کرتے ہیں تو الرٹ کرتا ہے۔
Billable ڈیفالٹ کے طور پر چیک کیا گیا۔ اس قاعدے کے لیے لاگت کو ٹریک کرنے کے لیے ان چیک کریں بغیر وقت کا اندراج پیدا کیے — اندرونی پروجیکٹس یا جذب شدہ اوور ہیڈز کے لیے مفید۔

جب مکمل ہو جائے تو Save Rule پر کلک کریں۔

ایک ریپو پر متعدد کلائنٹس

اگر ایک ہی ریپو کی مختلف برانچیں مختلف کلائنٹس سے تعلق رکھتی ہیں، تو Multiple clients on this repo کو چیک کریں اور محفوظ کریں۔ قاعدہ پھر بلنگ قواعد کی جدول میں ایک برانچ آئیکن دکھاتا ہے — Branch Rules کھولنے کے لیے اس پر کلک کریں۔

ہر برانچ قاعدہ ایک pattern (عین برانچ نام جیسے main, سنگل وائلڈ کارڈ جیسے client-a/*, یا recursive جیسے feature/**) اور اس کا اپنا کانٹیکٹ، پروجیکٹ، ریٹ، بلنگ موڈ، اور بجٹ سیٹنگز شامل کرتا ہے۔

قواعد اوپر سے نیچے میچ کیے جاتے ہیں — پہلا میچ جیتتا ہے۔

3. غیر تفویض شدہ اخراجات

Unassigned Costs سیکشن (جسے Vibes to Bucks: Show Unassigned Costs کے ذریعے بھی حاصل کیا جا سکتا ہے) ان ریپوز کی فہرست دیتا ہے جن کے AI اخراجات ٹریک کیے گئے ہیں لیکن ابھی تک کسی بلنگ قاعدے سے میل نہیں کھاتے۔ Assign پر کلک کریں کسی ریپو کے ساتھ Add Billing Rule فارم کو کھولنے کے لیے جس میں ریپوزٹری پہلے سے بھری ہوئی ہو۔

4. سیٹنگز

سیٹنگ یہ کیا کرتا ہے
Language ایکسٹینشن کے لیے UI زبان۔ 15 زبانیں دستیاب ہیں۔
Check for new costs every (minutes) کتنی بار ایکسٹینشن Cursor کو نئے استعمال کے لیے پول کرتی ہے۔ ڈیفالٹ: 5۔
Sync to billing software Daily — دن کے اختتام پر خودکار طور پر ہم آہنگی کرتا ہے۔ Manual — جب آپ ہم آہنگی کرنا چاہتے ہیں تو کمانڈ پیلیٹ سے Vibes to Bucks: Sync Now چلائیں۔
Fallback exchange rate (USD → EUR) جب لائیو ECB ریٹ دستیاب نہ ہو تو استعمال ہوتا ہے۔ پینل موجودہ لائیو ریٹ دکھاتا ہے اور آپ کو ایک کلک کے ساتھ تازہ ترین حاصل کرنے دیتا ہے۔
Display Currency EUR یا USD۔ اس سے ڈیش بورڈ اور اسٹیٹس بار میں اخراجات کیسے دکھائے جاتے ہیں متاثر ہوتا ہے۔

تبدیلیاں کرنے کے بعد Save Settings پر کلک کریں۔

5. AI Summarization (Pro)

جب ہم آہنگی کرتے ہیں، تو ایکسٹینشن آپ کے حالیہ git کمیٹس سے AI ماڈل کا استعمال کرتے ہوئے بامعنی وقت کے اندراج کی وضاحتیں پیدا کر سکتا ہے۔

فیلڈ یہ کیا کرتا ہے
AI provider Anthropic یا OpenAI۔
Model پریسیٹس سے منتخب کریں (مثلاً Claude Haiku 4.5) یا ایک کسٹم ماڈل ID درج کریں۔
API key اپنی کلید درج کریں اور Save Key پر کلک کریں۔ SecretStorage میں محفوظ طریقے سے اسٹور کیا جاتا ہے — کبھی بھی کنفیگ فائلز میں نہیں لکھا جاتا۔

ضروریات

اعلیٰ سطح: YAML حوالہ

Settings پینل ~/.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

ریموٹ معمول بنانا

Git ریموٹس کو میچ کرنے سے پہلے معمول بنایا جاتا ہے۔ ان سب کا نتیجہ github.com/acme/website پر ہوتا ہے:

repo ویلیوز کو host/org/repo کے طور پر لکھیں — کوئی پروٹوکول نہیں، کوئی .git نہیں۔

Moneybird IDs تلاش کرنا