Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

سوالات متداول

آیا PRECC برای استفاده امن است؟

بله. PRECC از مکانیزم رسمی hook PreToolUse کد Claude استفاده می‌کند – همان نقطه توسعه‌ای که Anthropic دقیقاً برای این منظور طراحی کرده است. هوک:

  • کاملاً آفلاین اجرا می‌شود (بدون فراخوانی شبکه در مسیر حساس)
  • در کمتر از ۵ میلی‌ثانیه تکمیل می‌شود
  • fail-open است: اگر مشکلی پیش بیاید، دستور اصلی بدون تغییر اجرا می‌شود
  • فقط دستورات را تغییر می‌دهد، هرگز خودش اجرا نمی‌کند
  • داده‌ها را به صورت محلی در پایگاه داده SQLite ذخیره می‌کند

آیا PRECC با سایر ابزارهای کدنویسی هوش مصنوعی کار می‌کند؟

PRECC به طور خاص برای Claude Code طراحی شده است. به پروتکل hook PreToolUse که Claude Code ارائه می‌دهد متکی است. با Cursor، Copilot، Windsurf یا سایر ابزارهای کدنویسی هوش مصنوعی کار نمی‌کند.

تله‌متری چه داده‌هایی ارسال می‌کند؟

تله‌متری فقط اختیاری است. وقتی فعال شود، ارسال می‌کند:

  • نسخه PRECC، سیستم‌عامل و معماری
  • شمارش‌های تجمیعی (دستورات رهگیری‌شده، مهارت‌های فعال‌شده)
  • میانگین تأخیر هوک

متن دستور، مسیر فایل، نام پروژه یا اطلاعات شناسایی شخصی ارسال نمی‌کند. قبل از فعال‌سازی می‌توانید بار دقیق را با precc telemetry preview مشاهده کنید. برای جزئیات تله‌متری را ببینید.

چگونه PRECC را حذف کنم؟

PRECC is fully reversible — remove it in three steps:

  1. حذف ثبت هوک:

    # Delete the hook entry from Claude Code's settings
# (precc init added it; removing it disables PRECC)

  2. حذف فایل باینری:

    rm ~/.local/bin/precc ~/.local/bin/precc-hook ~/.local/bin/precc-learner

  3. حذف داده‌ها (اختیاری):

    rm -rf ~/.local/share/precc/
rm -rf ~/.config/precc/

مجوز من منقضی شده. چه اتفاقی می‌افتد؟

PRECC به سطح Community بازمی‌گردد. تمام عملکردهای اصلی همچنان کار می‌کنند:

  • مهارت‌های داخلی فعال می‌مانند
  • خط لوله hook به طور عادی اجرا می‌شود
  • precc savings نمای خلاصه را نشان می‌دهد
  • precc ingest و استخراج جلسات کار می‌کنند

ویژگی‌های Pro تا تمدید غیرفعال می‌شوند:

  • precc savings --all (جزئیات کامل)
  • precc compress
  • precc gif
  • precc gha
  • precc geofence
  • گزارش‌های ایمیلی

به نظر می‌رسد هوک اجرا نمی‌شود. چگونه اشکال‌زدایی کنم؟

Run precc doctor first — it automates every check below. To diagnose by hand:

  1. بررسی کنید که هوک ثبت شده باشد:

    precc init

  2. هوک را به صورت دستی تست کنید:

    echo '{"tool_input":{"command":"cargo build"}}' | precc-hook

  3. بررسی کنید که فایل باینری در PATH شما باشد:

    which precc-hook

  4. پیکربندی hook در ~/.claude/settings.json را بررسی کنید.

آیا PRECC باعث کندی Claude Code می‌شود؟

خیر. هوک در کمتر از ۵ میلی‌ثانیه (p99) تکمیل می‌شود. این در مقایسه با زمانی که Claude صرف استدلال و تولید پاسخ می‌کند نامحسوس است.

آیا می‌توانم از PRECC در CI/CD استفاده کنم؟

PRECC برای جلسات تعاملی Claude Code طراحی شده است. در CI/CD، نسخه‌ای از Claude Code برای اتصال وجود ندارد. با این حال، precc gha می‌تواند اجراهای ناموفق GitHub Actions را از هر محیطی تحلیل کند.

مهارت‌های استخراج‌شده چه تفاوتی با مهارت‌های داخلی دارند؟

مهارت‌های داخلی با PRECC ارائه می‌شوند و الگوهای رایج پوشه اشتباه را پوشش می‌دهند. مهارت‌های استخراج‌شده از لاگ‌های جلسه خاص شما آموخته می‌شوند. هر دو در SQLite ذخیره و به طور یکسان توسط خط لوله hook ارزیابی می‌شوند.

آیا می‌توانم مهارت‌ها را با تیمم به اشتراک بگذارم؟

بله. هر مهارتی را با precc skills export NAME به TOML صادر کنید و فایل را به اشتراک بگذارید.

Why do I see zero tokens saved?

If precc savings reports 0 tokens despite an active Claude Code session burning input/output tokens, the hook is not firing. Three causes account for almost every reported instance:

  1. You are on v0.3.42 or v0.3.43. These releases shipped a data-path regression where the hook wrote metrics to a directory that the CLI then read from a different directory — both ran, but the savings number stayed at 0. Fixed in v0.3.44 (data paths routed through db::data_dir()). Upgrade with:

    precc update

  2. Your settings.json is missing the hook entry. Run precc doctor (available in v0.3.53+). It checks each precondition of the hot path — settings file, hook entry, binary on $PATH, heuristics DB, recent invocations — and reports the first one that fails:

    precc doctor

    If doctor is not available because you are on an older release, run precc init to (re)register the hook.

  3. Your session has not yet hit a skill trigger. PRECC only intercepts Bash commands matching one of the active skills. If your session has been pure file editing or pure web fetching against domains not covered by webfetch-opencli, you have not yet given the hook anything to compress or rewrite. This is normal. Run precc skills list to see what triggers exist.

If after upgrading and running precc doctor you still see zero savings, file an issue at https://github.com/peri-a-i/precc-cc/issues with the output of precc doctor.

My MCP server (e.g. lean-ctx) is pegging CPU. How do I kill it safely without taking Claude Code down with it?

PRECC does not ship or supervise MCP servers — but this is a recurring trap because some MCP binaries (notably lean-ctx) are also invoked as per-Bash-tool-call wrappers by the Claude Code harness, not just as long-running servers. A naive pkill <name> then matches many short-lived wrappers in addition to the server.

Identify the runaway PID, do not kill by name:

pgrep -f "^lean-ctx$" \
  | xargs -I{} ps -o pid,%cpu,etime,args -p {} \
  | sort -k2 -nr | head -3

The top row is the long-running server (large etime, high %cpu). Send SIGTERM to only that PID:

kill -TERM <pid>

Avoid these forms, all of which can also kill Claude Code or break in-flight tool calls:

  • pkill lean-ctx — matches transient lean-ctx -c <cmd> wrappers spawned per Bash tool call.
  • pkill -9 -f lean-ctx — same broad match, plus ungraceful exit leaves the MCP stdio half-open.
  • pkill -g <pgid> / kill -- -<pgid> — kills the whole process group, which includes claude itself when the MCP server shares a session with it.

If after a clean SIGTERM the server does not exit within a few seconds, escalate with kill -KILL <pid> on the same single PID (still not by name). Claude Code will lose those MCP tools until you restart it; it should not exit on its own.

This advice is independent of PRECC — but PRECC users frequently run lean-ctx, so it is worth documenting here.

What is OpenCLI and do I need it?

OpenCLI is a third-party Node.js tool that turns ~148 websites into structured-output CLI commands (opencli hackernews top, opencli reddit search <q>, opencli arxiv search <q>, …). PRECC ships two built-in skills that work with it:

  • webfetch-opencli-hint — fires on curl/wget/http/fetch against any of 11 OpenCLI-supported domains and suggest_fix-es the equivalent opencli <site> … command. Suggestion only; never modifies the command.
  • webfetch-opencli-hackernews — auto-rewrites curl|wget news.ycombinator.com to opencli hackernews top with an inline command -v opencli fallback to the original command if OpenCLI isn’t installed.

You don’t need OpenCLI for PRECC to work. The hint skill costs nothing; the auto-rewrite skill is safe to ship default-on because of the fallback.

If you want OpenCLI’s WebFetch token savings, install it with:

precc init --opencli

That runs npm install -g @jackwener/opencli (Node.js 20+ required). For cookie-reuse on logged-in pages, also install OpenCLI’s Chrome extension separately — see the project README. The extension requests broad permissions (debugger, <all_urls>, cookies); review them before installing.

precc doctor reports OpenCLI’s presence on $PATH as an informational line:

i opencli: installed (webfetch-opencli skills will auto-rewrite)

or

i opencli: not installed (run `precc init --opencli` if you want WebFetch token savings)

Never marks doctor as failing — the integration is fully opt-in.