تصور کنید یک برنامه‌نویس هستید که ساعت‌ها با یک عامل هوش مصنوعی روی یک باگ پیچیده کار کرده است، اما در جلسهٔ جدید، مدل دوباره همان راهکاری را پیشنهاد می‌دهد که دو ساعت پیش شکست خورده بود. این «فراموشی» عامل‌ها، یکی از بزرگ‌ترین موانع بهره‌وری در توسعهٔ نرم‌افزار با AI است. عامل‌های کدنویسی معمولاً هر جلسه را از صفر شروع می‌کنند و قادر نیستند بحث‌ها، تصمیمات، تلاش‌های شکست‌خورده و نتایج تست‌های ساعت‌های گذشته را بازیابی کنند. این وضعیت باعث می‌شود آن‌ها دستورات دقیقی که با خطا مواجه شده‌اند یا محدودیت‌هایی که در مراحل اولیه کار تعیین شده بود را فراموش کنند. ابزار ctx — یک رابط خط فرمان (CLI) متن‌باز — این مشکل را با ایندکس کردن لاگ‌های محلی عامل‌ها در یک پایگاه‌داده SQLite خصوصی روی ماشین کاربر حل می‌کند.
بسیاری از توسعه‌دهندگان در حال حاضر برای بازیابی زمینه (Context) به جست‌وجوی دستی در متن‌های خام (Raw Transcripts) یا خلاصه‌های فشرده متکی هستند. این روش‌ها یا آن‌قدر توکن‌بر هستند که مدل زبانی بزرگ (LLM) — مثل کتابخانه‌داری که میلیاردها صفحه را خوانده و حالا با همان لحن کتاب‌ها جواب می‌دهد — را کند می‌کنند، یا آن‌قدر مبهم‌اند که وقتی برنامه‌نویس می‌خواهد بداند دقیقاً چرا یک مهاجرت دیتابیس (Migration) خاص شکست خورده، کمکی نمی‌کنند. در واقع، چالش‌های تکیه بر تاریخچهٔ گفتگوها در حافظه نشان می‌دهد که چرا روش‌های سنتی ذخیره‌سازی لاگ‌ها برای نیازهای پیچیدهٔ عامل‌ها ناکافی هستند. ctx با ساختاردهی تاریخچه به جلسات (Sessions)، رویدادها (Events)، متادیتا و فیلدهای ایندکس‌شده، راهی فراهم می‌کند تا عامل‌ها به جای حدس زدن بر اساس یک خلاصه، به شواهد دقیق و مستند از گذشته استناد کنند.
همان‌طور که در تحلیل‌های قبلی ما درباره‌ی پروتکل‌های حافظه در مدل‌های عامل‌محور اشاره کردیم، جداسازی حافظه از پنجرهٔ متنی، کلید مقیاس‌پذیری است.
زمینه و معماری
به نقل از مستندات پروژه، این ابزار با زبان Rust نوشته شده و برای تضمین حریم خصوصی، کاملاً محلی عمل می‌کند. این سیستم منابع پشتیبانی‌شده را شناسایی کرده، رکوردهای ذخیره‌شده واقعی را وارد می‌کند و متادیتای نرمال‌سازی‌شده‌ی جلسات، رویدادها و فایل‌های تغییریافته (Touched-files) را در یک پایگاه‌داده SQLite محلی که برای بازیابی سریع بهینه شده است، ذخیره می‌کند.
به دلیل استفاده از ایندکس محلی، جست‌وجوها سریع و قابل اسکریپت‌نویسی هستند و نیازی به اجرای یک سرویس در پس‌زمینه (Background Service) ندارند. این ایندکس به صورت پیش‌فرض خصوصی است. متن گفتگوها دقیقاً همان‌طور که هستند حفظ می‌شوند، از جمله مسیرهای محلی و رشته‌هایی که شبیه به رمزهای عبور یا توکن‌های حساس هستند؛ به همین دلیل کاربران باید پیش از اشتراک‌گذاری خروجی‌های کپی‌شده در خارج از ماشین خود، آن‌ها را بررسی کنند.
اکوسیستم‌های پشتیبانی‌شده
طبق گزارش توسعه‌دهندگان، ctx می‌تواند تاریخچهٔ محلی ذخیره‌شده در محیط‌های مختلف عامل‌ها را شناسایی کرده و آن‌ها را برای وارد کردن به ایندکس جست‌وجو بخواند. ارائه‌دهندگان پشتیبانی‌شده عبارتند از:
- Claude Code و Cursor
- Codex و OpenCode
- Copilot CLI و Gemini CLI (Antigravity)
- Factory AI Droid و Pi
در کنار این قابلیت‌های حافظه، استانداردهایی برای بهبود تعامل عامل‌ها با ابزارها در حال شکل‌گیری است؛ برای مثال هگینگ‌فیس با معرفی استاندارد ARD تلاش کرده است تا فرآیند شناسایی ابزارها برای عامل‌ها را خودکار و بهینه‌تر کند.
کاربران می‌توانند با اجرای دستور ctx sources --json روی ماشین خود، مشاهده کنند که در حال حاضر کدام منابع خاص قابل وارد کردن (Importable) هستند.
مکانیسم فنی
از نظر فنی، این ابزار ۵۰ برابر بهینه‌تر از جست‌وجوی خام در متن‌هاست؛ زیرا به جای ریختن کل لاگ‌ها در پنجرهٔ زمینه (Context Window) — که شبیه میز کاری است که فقط جای چند ورق دارد، نه کل کتابخانه — نتایج رتبه‌بندی‌شده و مستند را برمی‌گرداند. جست‌وجوی خام معمولاً آن‌قدر توکن‌بر است که عملاً داشتن آن با نداشتن هیچ تاریخچه قابل استفاده برابر است.
تعامل با ایندکس از طریق چندین دستور CLI صورت می‌گیرد:
- جست‌وجوی کلی: دستور
ctx search "failed migration"از زبان طبیعی برای یافتن موارد استفاده می‌کند. - جست‌وجوی فایل‌محور: دستور
ctx search --file crates/foo/src/lib.rsرویدادهایی را می‌یابد که یک فایل خاص را تغییر داده یا لمس کرده‌اند. - جست‌وجوی ترکیبی: استفاده از چندین عبارت مانند
ctx search --term "failed migration" --term rollback --term "cursor rename"نتایج را محدودتر و دقیق‌تر می‌کند. - بازبینی: دستور
ctx show event <ctx-event-id> --window 3بخش خاصی از یک گفتگو یا لاگ قدیمی را چاپ می‌کند، در حالی کهctx show session <ctx-session-id>یک نسخه فشرده از کل تاریخچه آن جلسه را نمایش می‌دهد.
برای کاربران پیشرفته، ctx امکان اجرای کوئری‌های SQL فقط-خواندنی (Read-only) را فراهم می‌کند تا مستقیماً داده‌های ایندکس محلی را تحلیل کنند؛ برای مثال با اجرای دستور: ctx sql "SELECT provider, COUNT(*) AS sessions FROM ctx_sessions GROUP BY provider".
ادغام و حریم خصوصی
برای ادغام این ابزار، عامل‌ها می‌توانند از «مهارت ctx» (ctx skill) از طریق مارکت‌پلیس یا نصب پلاگین برای Codex، Claude Code، Cursor و مهارت‌های خام عامل‌ها (Raw Agent Skills) استفاده کنند. فایل باینری این ابزار از به‌روزرسانی‌های خودکار امضاشده از طریق دستورات ctx upgrade check و ctx upgrade status پشتیبانی می‌کند تا ایندکس‌کننده همواره به‌روز بماند.
از آنجا که ایندکس محلی است، ctx هیچ پرامپت، متن گفتگو یا تاریخچه ایندکس‌شده‌ای را به سرویس‌های ابری نمی‌فرستد. این ابزار مدل‌های API را فراخوانی نمی‌کند، نیازی به API Key ندارد و هیچ چیزی در مخازن کد (Source Repositories) نمی‌نویسد. همچنین شامل مستندات محلی و قابلیت تولید man-page از طریق دستور ctx docs است.
این تغییر، حافظهٔ عامل را از «خلاصه‌های برداری» (Vectorized Summaries) به «لاگ‌های قابل تایید» (Verifiable Logs) منتقل می‌کند. در حالی که ابزارهایی مثل Graphify وضعیت فعلی یک مخزن (فایل‌ها، نمادها و ایمپورت‌ها) را نقشه‌برداری می‌کنند، ctx در جلسات قبلی عامل‌ها جست‌وجو می‌کند تا توضیح دهد در حین تغییرات توسط انسان‌ها و عامل‌ها، چه اتفاقی افتاده است. این تمایز برای عیب‌یابی بازسازی‌های (Refactors) پیچیده که در آن‌ها «چرا» مهم‌تر از «چه چیزی» است، حیاتی است.
برای توسعه‌دهنده، این یعنی پایان چرخهٔ تکراری که در آن هوش مصنوعی یک راهکار شکست‌خورده را سه بار در یک بعدازظهر پیشنهاد می‌دهد. این ابزار، مدل را از یک ابزار بدون وضعیت (Stateless) به همکاری تبدیل می‌کند که حافظه‌ای بلندمدت و قابل جست‌وجو از تکامل پروژه دارد.
کاربران می‌توانند با اجرای اسکریپت نصب curl -fsSL https://ctx.rs/install | sh و مقداردهی اولیه فضای ذخیره‌سازی محلی با دستور ctx setup شروع به ایندکس کردن جلسات موجود خود کنند.
گام بعدی شما
- نصب ابزار با دستور
curl -fsSL https://ctx.rs/install | shو اجرایctx setupبرای شروع ایندکسینگ. - بررسی منابع پشتیبانی‌شده در سیستم خود با دستور
ctx sources --json. - جایگزینی جست‌وجوی دستی در تاریخچهٔ چت‌ها با دستورات
ctx searchبرای تحلیل سریع‌تر خطاهای تکراری.
اما داستان سخت‌افزاری این تحول حتی شگفت‌انگیزتر است — به تحلیل ما درباره‌ی تراشه‌های Blackwell مراجعه کنید.
گفتگو