استفاده از PRECC با Cursor

PRECC به عنوان یک قلاب PreToolUse برای Claude Code ساخته شده است، اما کتابخانهٔ مهارت‌های زیرین آن — cargo-wrong-dir، git-wrong-dir، npm-wrong-dir، jj-translate و موارد مشابه — مستقل از ویرایشگر است. با یک قطعه‌کد کوچک شِل می‌توانید هر فرمانی را که در پایانهٔ یکپارچهٔ Cursor تایپ می‌شود از طریق precc-hook مسیریابی کنید تا همان بازنویسی‌هایی که در Claude Code توکن صرفه‌جویی می‌کنند، در Cursor هم چنین کنند.

Requires precc ≥ 0.3.45. Earlier versions don’t plant the integration scripts under <data_dir>/integrations/cursor/. Run precc update to upgrade if you have an older release.

آنچه پوشش داده می‌شود

این یکپارچه‌سازی فرمان‌هایی را می‌گیرد که شما در پایانهٔ Cursor تایپ می‌کنید. در zsh پیش از فشردن Enter، خط فرمان به‌صورت خودکار بازنویسی می‌شود؛ در bash تنها امکان هشدار وجود دارد (تلهٔ DEBUG پس از قطعی‌شدن فرمان فعال می‌شود). فرمان‌هایی که عامل Cursor به‌صورت زیرفرایندهای bash -c اجرا می‌کند، مقداردهی اولیهٔ شِل تعاملی شما را بارگذاری نمی‌کنند، بنابراین قلاب آن‌ها را نمی‌بیند؛ پر کردن این شکاف نیازمند یک شیم PATH است که هنوز در این دایرکتوری وجود ندارد. فراخوانی‌های ابزار غیر-شِل Cursor (ویرایش فایل، جست‌وجوی کد) نیز خارج از محدودهٔ این یکپارچه‌سازی هستند.

نصب

zsh (بازنویسی خودکار)

source ~/.local/share/precc/integrations/cursor/precc-preexec.zsh

یک بار precc init را اجرا کنید — این دستور اسکریپت را در مسیر بالا قرار می‌دهد (از <data_dir> ذخیره‌سازی precc استفاده می‌کند، بنابراین CLAUDE_CONFIG_DIR و سایر جداسازی‌های پروفایل رعایت می‌شوند). سپس خط source را به ~/.zshrc اضافه کنید. precc-hook و jq باید در PATH موجود باشند؛ در صورت نبود هرکدام، اسکریپت بدون هیچ اثری به‌درستی از کار می‌افتد.

bash (فقط هشدار)

source ~/.local/share/precc/integrations/cursor/precc-preexec.bash

یک بار precc init را اجرا کنید — این دستور اسکریپت را در مسیر بالا قرار می‌دهد. سپس خط source را به ~/.bashrc اضافه کنید. تله DEBUG بازنویسی پیشنهادی را بدون اعمال آن در stderr چاپ می‌کند؛ می‌توانید پیشنهاد را به‌صورت دستی کپی کنید.

راستی‌آزمایی

در پایانهٔ Cursor، با cd /tmp (یا هر جایی خارج از یک پروژهٔ Rust) شروع کنید و یک فرمان ساخت Rust تایپ کرده سپس Enter را بزنید. در zsh بافر باید در همان جا به شکل بازنویسی‌شده توسط PRECC تغییر کند (معمولاً افزودن پیشوندی به سبک cd PATH && …). در bash باید خطی به شکل [precc] suggested rewrite: … در stderr ببینید.

هشدارها و محدودیت‌ها

• تأخیر precc-hook به ازای هر کلید را اضافه می‌کند. قلاب هدف <5 ms p50 را دنبال می‌کند، اما p99 روی کش سرد بالاتر است؛ به یادداشت‌های تأخیر قلاب در همین کتاب مراجعه کنید.
• هیچ سنجش از راه دوری از این مسیر گزارش نمی‌شود. قلاب با هر agent_class که تشخیص دهد گزارش می‌دهد، که claude-code نخواهد بود — صرفه‌جویی‌های Cursor شما در صفحهٔ آمار عمومی ظاهر نخواهند شد.
• دلیل بازنویسی برای یک فشار کلید از طریق zle -M نمایان می‌شود. آرام، نه مدال.
• برای پوشش عامل، یک شیم PATH (پوشش‌دهنده‌ها در ~/.precc/bin/cargo، ~/.precc/bin/git، …) گام بعدی برنامه‌ریزی‌شده است.