pu.sh؛ یه ایجنت کدنویسی زیر ۵۰ کیلوبایت
خلاصهٔ کاملتر
نویسنده تو این پروژه یه سؤال رو دنبال کرده: قابلحملترین بستر اجرای یه ایجنت کدنویسی چی میتونه باشه که هرجایی اجرا بشه؟ جوابی که بهش رسیده یه اسکریپت شله. به گفتهی نویسنده خود حلقهی ایجنت — یعنی فرستادن پرامپت، پارس کردن جواب، اجرای ابزار، اضافه کردن به تاریخچه و تکرار — خیلی کوچیکه و بقیهی کار فقط تجربهی کاربری و مقاومسازیه.
نصبش هم در همین حد سادهست: فایل اسکریپت رو با curl میگیری، اجراییش میکنی و تمومه. نه npm، نه pip، نه Docker، نه Node. فقط یه فایل شل و چند ابزار رایج یونیکس و یه کلید API لازمه. نویسنده تأکید میکنه که نسخهی فعلی pu.sh حدود ۴۹ کیلوبایته و عمداً زیر مرز ۵۰ کیلوبایت نگه داشته شده.
این ابزار هفتتا ابزار پایه داره — bash، read، write، edit، grep، find و ls — و یه REPL تعاملی چندمرحلهای با حافظه. هم Anthropic رو پشتیبانی میکنه (از طریق Messages API) هم OpenAI رو (از طریق Responses API)، و برای حالت reasoning آیتمهای مربوطه رو بین نوبتها حفظ میکنه. ویرایش فایل هم بهصورت جایگزینی دقیق متن قدیم با متن جدیده و درخواستهای مبهم یا غیریکتا رو رد میکنه.
نکتهی جالب مقاله مقایسهی حجمه: نویسنده میگه پوشهی node_modules یه ایجنت کدنویسی معمولی از کل سورسکد بازی Doom هم سنگینتره، اونهم سه برابر. در مقابل pu.sh از خیلی از فایلهای README کوچیکتره. ابزارهای واقعی مثل Claude Code و Goose CLI صدها مگابایت و نسخهی داکری SWE-agent حدود ۱.۸ گیگابایته.
نویسنده صادقانه میگه این ابزار محدودیت هم داره: نه TUI داره، نه نمایش جریانی (streaming)، نه ورودی تصویر، نه لاگین مرورگری، و نه پشتیبانی بومی ویندوز. حتی پارسر JSON کاملی هم نداره و بهجاش از پارس هدفمند با awk برای شکل جواب هر ارائهدهنده استفاده میکنه.
بخش شیرین مقاله جاییه که نویسنده باگهایی که موقع ساخت پیدا کرده رو میگه؛ مثلاً اینکه set -e تو شل میتونه بیصدا اسکریپت رو بکشه، برای همین بهجاش از set -u استفاده کردن. یا اینکه sed روی مک با sed گنو فرق داره و مجبور شدن سراغ awk برن. به گفتهی نویسنده، pu.sh یه ابزار جدی برای کار روزمره نیست ولی برای CI/CD، کانتینرها، ماشینهای لبهای و فهمیدن اینکه ایجنتها واقعاً چطور کار میکنن گزینهی خوبیه چون میشه کل کدش رو سرتاسر خوند و فهمید.
نکات کلیدی:
- pu.sh یه ایجنت کدنویسی تو یه فایل شل زیر ۵۰ کیلوبایته، بدون هیچ پکیجی
- فقط به curl، awk، چند ابزار یونیکس و یه کلید API نیاز داره
- هفت ابزار پایه داره و هم با Anthropic هم با OpenAI کار میکنه
- نویسنده میگه حلقهی اصلی یه ایجنت کوچیکه و بقیهش تجربهی کاربری و سختسازیه
- محدودیتهایی مثل نبود TUI، streaming، ورودی تصویر و پشتیبانی ویندوز داره




