ledger
حافظهٔ پروژهٔ شما، بین نشستها
کلود کد (Claude Code) با هر بار ریستشدن کانتکست، همهچیز را فراموش میکند.
یک /compact، یک /clear یا بستن ترمینال — و هدفها، تصمیمها، بنبستهایی که قبلاً کنار گذاشته بودید و دقیقاً همان خطی که میخواستید بنویسید، همه از بین میرود. هر نشست را با ده دقیقه توضیح دوبارهٔ «کجا بودیم» شروع میکنید.
ledger همین را حل میکند. مجموعهای کوچک از فایلهای زنده را نگه میدارد که خودشان بهروز میشوند — تا هر نشست، حتی نشستی که بعد از یک compaction سرد بالا میآید، دقیقاً بداند چه چیزی تمام شده، چه چیزی در حال انجام است، چه چیزی بلاک شده، و گام بعدی دقیق کدام است.
خودش کار میکند. شما هیچوقت صدایش نمیزنید.
نسخهٔ ۳۰ ثانیهای
به محض باز کردن پروژه در Claude Code، پیش از اولین پیام شما، این بریفینگ بهصورت خودکار تزریق میشود:
── ledger · auto-catchup ──
• نشست قبلی: auth refresh flow
• گام بعدی دقیق:
اینترسپتورِ 401-retry را در src/lib/api.ts:refresh() سیمکشی کن
— راهحل کوکی کنار گذاشته شد (ریسِ service-worker).
• در حال انجام:
- [~] wire 401-retry interceptor in src/lib/api.ts
• بلاکشده:
- [!] OAuth callback — blocked: دسترسی Google console در انتظار
• کامیتهای پس از نشست قبلی: 3a1f2e9 add refresh stub
• درخت کاری: ۱ فایل کامیتنشده.
شما درخواستش نکردید. لازم نیست بنبستی را که قبلاً رفته بودید به یاد بیاورید. فقط ادامه میدهید.
وقتی نشست تمام میشود — یا Claude Code وسط کار compact میکند — ledger همهچیز را بهصورت خودکار روی دیسک اسنپشات میگیرد. حلقه بسته میشود. هیچچیز گم نمیشود.
نصب
ledger دو شکل دارد. پلاگین همان چیزی است که بیشتر مردم میخواهند: اتوماسیون را برایتان سیمکشی میکند.
بهصورت پلاگین (پیشنهادی — خودش کار میکند)
# داخل Claude Code:
/plugin marketplace add realdeal88/ledger-fa
/plugin install ledger@ledger-fa
همین. هر پنج هوک هنگام نصب ثبت میشوند. هر پروژهای را باز کنید، یکبار /ledger init را اجرا کنید، و ردیابی فعال است.
بهصورت اسکیل مستقل (فقط دستور /ledger، بدون هوک خودکار)
اگر فقط دستور /ledger را میخواهید و ترجیح میدهید هوک نصب نکنید:
git clone https://github.com/realdeal88/ledger-fa
cp -r ledger-fa/skills/ledger ~/.claude/skills/ledger
نکتهٔ namespace: نصبشده بهصورت پلاگین، دستور /ledger:ledger است (Claude Code اسکیلهای پلاگین را namespace میکند). نصبشده بهصورت اسکیل مستقل، فقط /ledger است.
شروع سریع
# ۱. پروژه را در Claude Code باز کنید
# ۲. فایلهای زنده را بسازید (یکبار برای هر پروژه — هیچچیزی را بازنویسی نمیکند):
/ledger init
# ۳. ...فقط کار کنید.
از اینجا به بعد کاری لازم نیست. ledger همهچیز را بهروز نگه میدارد. دفعهٔ بعد که پروژه را باز کنید — یا لحظهای که Claude Code کامپکت کند — وضعیتتان از قبل ذخیره و دوباره خوانده شده است.
برای یک handoff کامل و دستی پیش از رفتن: /ledger handoff — و برای بازیابی کامل کانتکست: /ledger (یا /ledger catchup).
چطور کار میکند
قاعدهٔ طراحی یک خط است: نظم با هوک تضمین میشود، نه با حافظهٔ مدل. هر سیستم ردیابی که به «یادش بماند بهروزرسانی کند» تکیه کند، به یک شکل شکست میخورد — همان نشستی که فراموش میکند، همان نشستی است که کرش میکند و وضعیت از بین میرود. ledger نوشتن را مکانیکی و از طریق پنج هوک غیرمسدودکننده تضمین میکند.
| کِی | هوک | چه اتفاقی میافتد |
|---|
| شروع نشست | ledger-catchup.sh | بریفینگ auto-catchup را تزریق میکند — آخرین موضوع، گام بعدی دقیق، تسکهای در حال انجام و بلاکشده، و دلتای کامیتهای پس از نشست قبلی. |
| حین کار | ledger-drift.sh | یک یادآور debounceشده (حداکثر هر ۲۵ دقیقه) — فقط وقتی کد تغییر میکند ولی فایلهای زنده تکان نخوردهاند. در بقیهٔ مواقع ساکت. |
| هنگام ویرایش فایلهای زنده | ledger-dashboard.sh | داشبورد HTML را بازتولید میکند (debounceشده). اختیاری. |
| پیش از compaction | ledger-checkpoint.sh | SESSION.md را اسنپشات میگیرد، به LOG.md اضافه میکند، فایلهای زنده را کامیت میکند. |
| پایان نشست | ledger-checkpoint.sh | همان اسنپشات، تا ترمینالِ تازهٔ فردا بدون از دست رفتن یک ضربآهنگ ادامه دهد. |
دو چیز این را قابلاعتماد میکند:
