Pu.sh: 400-строчная оболочка для агента кодирования с HN

Pu.sh — это полноценный каркас для агентов кодирования, написанный примерно на 400 строках shell-скрипта и разработанный для максимальной переносимости. Требуются только sh, curl и awk — никаких npm, pip, Docker или других зависимостей. Проект вдохновлён Pi (pi.dev) и использует ту же поверхность из 7 инструментов и модель редактирования точного текста.

Ключевые особенности

• Поддерживаемые модели: Anthropic (Claude) и OpenAI
• 7 встроенных инструментов: bash, read, write, edit, grep, find, ls
• REPL-режим для интерактивного использования
• Автоматическое уплотнение контекста разговора
• Возможности контрольных точек/возобновления
• Конвейерный режим для скриптов
• 90 тестов без API для проверки функциональности без внешних вызовов

Примечательно отсутствует: TUI, стриминг, поддержка изображений, OAuth, совместимость с Windows — и, как выражается автор, «достоинство».

Код и философия

Автор признаётся, что не может прочитать большую часть кода awk, написанного Pi/Claude/Codex. Цикл рассуждений обрабатывает JSON-парсинг и вызовы инструментов через awk. Сам цикл агента крошечный — большая часть сложности в реальных CLI агентов связана с DX и отказоустойчивостью. Проект выпущен под самоустановленным правилом: никаких новых зависимостей и менее 500 строк кода.

Установка

curl -sL pu.dev/pu.sh -o pu.sh && chmod +x pu.sh
./pu.sh

Всё, что нужно — это curl, awk и API-ключ. Автор призывает читателей создавать свои собственные каркасы, адаптированные под их нужды.