প্রকল্প সম্পর্কে

cctrace হল একটি লোকাল, জিরো-কনফিগ TLS-ইন্টারসেপ্টিং প্রক্সি যা কোডিং এজেন্ট (Claude Code, OpenAI Codex CLI, Grok CLI, Kimi Code CLI এবং opencode) এবং তাদের নিজ নিজ API-এর মধ্যে বসে, প্রতিটি HTTP কল রিয়েল টাইমে ধারণ করে। বেস-URL প্রক্সিগুলির বিপরীতে যেগুলি শুধুমাত্র চ্যাট এন্ডপয়েন্ট দেখে, cctrace ট্রান্সপোর্ট লেয়ারে ইন্টারসেপ্ট করে, যার ফলে OAuth ফ্লো, ব্যবহার/ক্রেডিট এন্ডপয়েন্ট, MCP রেজিস্ট্রি কল, বুটস্ট্র্যাপ রিকোয়েস্ট এবং টেলিমেট্রি পর্যন্ত পৌঁছায় যা একটি সাধারণ URL রিরাইট দেখতে পারে না। টুলটি স্বয়ংক্রিয়ভাবে একটি CA সার্টিফিকেট তৈরি করে এবং HTTPS_PROXY-এর মাধ্যমে এজেন্টকে এটির মাধ্যমে রুট করার জন্য কনফিগার করে, যার জন্য কোনো ম্যানুয়াল সেটআপের প্রয়োজন হয় না। ফার্স্ট-পার্টি হোস্টগুলি ডিক্রিপ্ট করে সম্পূর্ণরূপে ধারণ করা হয়; বাহ্যিক হোস্টগুলি (npm, GitHub, apt) অস্বচ্ছ বাইট-কাউন্টেড টানেল হিসাবে পাস হয়, যার ফলে ট্রেসগুলি হালকা থাকে। লাইভ ওয়েব UI ফিল্টার চিপ সহ শ্রেণীবদ্ধ রিকোয়েস্ট ভিউ, ডিকোডেড SSE স্ট্রিম, রিজনিং-এফোর্ট এবং প্রম্পট-ক্যাশে রায়, প্রথম-টোকেন লেটেন্সি এবং প্রতি-রিকোয়েস্ট আনুমানিক খরচ প্রদান করে। সেশনগুলি মানুষের গণনা পদ্ধতিতে পুনর্গঠিত হয়, যেখানে সময়ের সাথে লেন দেখানো একটি ট্র্যাজেক্টোরি বার, স্পর্শ করা ফাইলগুলির নাম দেওয়া টুল সারি, সাবএজেন্ট শাখা, মডেল ইপক এবং কমপ্যাকশন সীমানা থাকে। সেশন রিপ্লে যেকোনো ধারণ করা সেশনকে ধাপে ধাপে বা প্লেব্যাক করে, সক্রিয় চলাকালীন লাইভ টেইলিং সহ। একটি কনটেক্সট ভিউ সময়ের সাথে এজেন্টের উইন্ডো দেখায় একটি ইন্টারেক্টিভ ওভারভিউ সহ: ছয়টি কনটেক্সট ক্যাটাগরি দ্বারা রঙিন প্রতি-ওয়্যার রিকোয়েস্টে স্তম্ভিত কলাম, কমপ্যাকশন মার্কার এবং ওয়াল-ক্লক ব্রেকডাউন। নির্বাচনটি তিনভাবে পড়া যায়: একটি কনটেক্সট গ্রাফ (আইসিকল ডিকম্পোজিশন), রেকর্ডের একটি লিনিয়ার স্ট্রিম, বা ইনজেকশন এবং কমপ্যাকশনের ইভেন্ট টাইমলাইন হিসাবে। খরচ ট্র্যাকিং দেখায় কোটা কোথায় যায় ক্যাশে রিড/রাইট/ইনপুট/আউটপুট ব্রেকডাউন সহ, ক্যাশে মিসের কারণ চিহ্নিত করে (মেয়াদোত্তীর্ণ TTL, প্রিফিক্স পরিবর্তন, 529 রিট্রাই), এবং ক্লায়েন্ট দ্বারা পোল করা অ্যাকাউন্ট কোটা প্রদর্শন করে। ইনসাইটস কমান্ড দিন, প্রজেক্ট এবং ক্লায়েন্ট অনুসারে রান জুড়ে একত্রিত করে, ক্যাশে স্প্লিট এবং কোটা শতাংশের জন্য ঐচ্ছিক গভীর স্ক্যানিং সহ। ডক্টর কমান্ড একটি সেশনের সর্বশেষ রিকোয়েস্ট উইন্ডো নির্ণয় করে, অব্যবহৃত টুল স্কিমা, পুনরাবৃত্ত হ্যারনেস ইনজেকশন, ডুপ্লিকেট কনটেন্ট এবং ক্যাশে অদক্ষতা সনাক্ত করে কার্যকরী লিভার সহ। ট্রেসগুলি .jsonl ফাইল হিসাবে সংরক্ষিত হয় (.jsonl.zst-এ আর্কাইভ করা), cctrace view দিয়ে যেকোনো সময় পুনরায় খোলা যায় এবং মার্কডাউন ট্রান্সক্রিপ্ট বা অফলাইন HTML স্ন্যাপশট হিসাবে রপ্তানি করা যায়। একটি ক্রস-প্রজেক্ট ড্যাশবোর্ড সমস্ত লাইভ এবং সমাপ্ত রান দেখায় এক-ক্লিক সেশন ভিউ, স্টপ কন্ট্রোল এবং স্টোরেজ ম্যানেজমেন্ট সহ। ক্রেডেনশিয়ালগুলি হেডার, বডি এবং URL থেকে ডিস্কে কিছু লেখার আগে রিড্যাক্ট করা হয়। ট্রেসগুলি প্রজেক্ট ট্রির বাইরে ~/.local/share/cctrace/-এ থাকে। টুলটির জন্য Bun, openssl এবং টার্গেট CLI প্রয়োজন এবং এটি npm বা একটি স্বতন্ত্র কম্পাইলড বাইনারি হিসাবে উপলব্ধ।