কনফিগারেশন

সবকিছু Settings panel এর মাধ্যমে কনফিগার করা যায় — এটি খুলতে Vibes to Bucks: Cost Tracking & Billing Setup ব্যবহার করুন Cursor command palette এ। YAML সম্পাদনার প্রয়োজন নেই।

১. আপনার বিলিং সফটওয়্যার সংযুক্ত করুন (Pro)

Billing software এর অধীনে, Moneybird বা Harvest নির্বাচন করুন।

আপনার API Token প্রবেশ করান এবং Test Connection এ ক্লিক করুন। সংযুক্ত হওয়ার পর, Administration এবং User ড্রপডাউনগুলি আপনার অ্যাকাউন্ট থেকে স্বয়ংক্রিয়ভাবে পূরণ হবে। সঠিক administration এবং user নির্বাচন করুন — সময় এন্ট্রিগুলি এই 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 panel এ API Token ফিল্ডে এটি পেস্ট করুন

আপনার Harvest টোকেন পাওয়া

  1. Harvest এ যান Developers → Personal Access Tokens
  2. Create new personal access token এ ক্লিক করুন, একটি নাম দিন এবং টোকেনটি কপি করুন
  3. আপনার Account ID ও প্রয়োজন — আপনার অ্যাকাউন্ট নামের পাশে একই পৃষ্ঠায় প্রদর্শিত
  4. উভয়টি Vibes to Bucks Settings panel এ পেস্ট করুন

২. বিলিং নিয়ম যোগ করুন

বিলিং নিয়মগুলি এক্সটেনশনকে বলে কোন ক্লায়েন্ট এবং প্রকল্পে AI খরচ বরাদ্দ করতে হবে। Settings panel খুলুন এবং Add Billing Rule এ স্ক্রোল করুন।

আপনি কী ট্র্যাক করতে চান?

নিয়ম ক্ষেত্র

Field এর কাজ
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 মোড নির্বাচিত হলে প্রদর্শিত হয়। ডিফল্ট ৫ (প্রতি €১ AI খরচ = €৫ বিল)।
Weekly budget cap এই নিয়মের জন্য প্রতি সপ্তাহে সর্বাধিক AI খরচ সেট করতে চেক করুন। এক্সটেনশনটি আপনাকে ২৫%, ৫০%, ৭৫%, ৮৫%, ৯৫% এবং সীমা অতিক্রম করলে সতর্ক করে।
Billable ডিফল্টভাবে চেক করা। এই নিয়মের জন্য খরচ ট্র্যাক করতে আনচেক করুন, সময় এন্ট্রি তৈরি না করেই — অভ্যন্তরীণ প্রকল্প বা শোষিত ওভারহেডের জন্য উপকারী।

Save Rule এ ক্লিক করুন কাজ শেষ হলে।

এক রেপোতে একাধিক ক্লায়েন্ট

যদি একই রেপোর বিভিন্ন শাখা বিভিন্ন ক্লায়েন্টের হয়, Multiple clients on this repo চেক করুন এবং সংরক্ষণ করুন। নিয়মটি তখন Billing Rules টেবিলে একটি শাখা আইকন দেখায় — এটি খুলতে Branch Rules এ ক্লিক করুন।

প্রতিটি শাখা নিয়ম একটি pattern যোগ করে (যেমন main, একক wildcard যেমন client-a/*, বা recursive যেমন feature/**) এবং তার নিজস্ব contact, project, rate, billing mode, এবং budget সেটিংস।

নিয়মগুলি উপরে থেকে নিচে মেলে — প্রথম মিলটি জয়ী হয়।

৩. Unassigned costs

Unassigned Costs বিভাগ (এছাড়াও Vibes to Bucks: Show Unassigned Costs এর মাধ্যমে পৌঁছানো যায়) এমন রেপো তালিকাভুক্ত করে যার ট্র্যাক করা AI খরচ এখনও কোনো বিলিং নিয়মের সাথে মেলে না। একটি রেপোর পাশে Assign এ ক্লিক করুন Add Billing Rule ফর্মটি খোলার জন্য, যেখানে রেপোসিটরি পূর্ব-ভর্তি থাকে।

৪. সেটিংস

Setting এর কাজ
Language এক্সটেনশনের UI ভাষা। ১৫টি ভাষা উপলব্ধ।
Check for new costs every (minutes) কত ঘন ঘন এক্সটেনশন Cursor থেকে নতুন ব্যবহার পোল করে। ডিফল্ট: ৫।
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 এ ক্লিক করুন।

৫. AI Summarization (Pro)

সিঙ্ক করার সময়, এক্সটেনশনটি আপনার সাম্প্রতিক git কমিট থেকে একটি AI মডেল ব্যবহার করে অর্থপূর্ণ সময় এন্ট্রি বিবরণ তৈরি করতে পারে।

Field এর কাজ
AI provider Anthropic বা OpenAI।
Model প্রিসেট থেকে নির্বাচন করুন (যেমন Claude Haiku 4.5) বা একটি কাস্টম মডেল ID প্রবেশ করান।
API key আপনার কী প্রবেশ করান এবং Save Key এ ক্লিক করুন। SecretStorage এ নিরাপদে সংরক্ষিত — কখনোই কনফিগ ফাইলে লেখা হয় না।

প্রয়োজনীয়তা

উন্নত: 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

রিমোট স্বাভাবিকীকরণ

Git remotes মেলানোর আগে স্বাভাবিকীকরণ করা হয়। এগুলি সব github.com/acme/website এ রূপান্তরিত হয়:

repo মানগুলি host/org/repo হিসাবে লিখুন — কোনো প্রোটোকল নেই, .git নেই।

Moneybird IDs খুঁজে পাওয়া