Mulch CLI
CLI ml хранит опыт агентов в JSONL внутри репозитория: соглашения, ошибки и решения читают все агенты команды после клона
- 339 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хук Claude Code и файлы в `.mulch/` меняют репозиторий, а записи попадают в историю git
- Агент записывает то, что сам счел выводом, поэтому ошибочные записи распространяются на всю команду
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/mulchОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хук Claude Code и файлы в `.mulch/` меняют репозиторий, а записи попадают в историю git
- Агент записывает то, что сам счел выводом, поэтому ошибочные записи распространяются на всю команду
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Mulch ставит утилиту `ml`, которая ведет папку `.mulch/` в репозитории. Перед завершением задачи агент вызывает `ml record` и записывает вывод, в начале сессии `ml prime` отдает ему индекс накопленного. Модели внутри Mulch нет: утилита хранит и выдает записи. Записи лежат в `.mulch/expertise/<домен>.jsonl`, по одному файлу на домен знаний и по одной записи на строку. Типов шесть: `convention`, `pattern`, `failure`, `decision`, `reference` и `guide`. Класс записи (`foundational`, `tactical` или `observational`) задает срок жизни, а необязательные привязки связывают ее с файлами, коммитами и задачами. Папка идет в git, поэтому клон репозитория сразу приносит опыт команды. `ml prime` выдает компактный индекс в пределах бюджета токенов (по умолчанию 4000) и ставит выше сбои и подтвержденные записи. `ml search` ранжирует по BM25, `ml stale` находит устаревшее, `ml prune` отправляет лишнее в архив. `ml setup claude` ставит хук для Claude Code, поддержаны также cursor и codex, а `ml onboard` готовит фрагмент для AGENTS.md или CLAUDE.md.
Для кого. Командам, где несколько агентов работают над одним репозиторием и повторяют одни ошибки из сессии в сессию.
Подходит, если
- Агент второй раз запускает VACUUM внутри транзакции, и урок надо сохранить как `failure` с решением
- Новый участник клонирует репозиторий, и его агент сразу знает соглашения по базе данных и API
- Перед задачей следует подгрузить только записи про изменяемые файлы командой `ml prime --files src/foo.ts`
- Накопленное устаревает, и `ml stale` покажет записи, чьи файлы часто менялись
Не подходит, если
- Нужна векторная память с эмбеддингами: Mulch ищет по BM25 в файлах JSONL
- Знания должны ходить между машинами без git
- Хватает одного CLAUDE.md с парой правил
- В окружении нет ни Bun, ни Node: основной путь установки идет через Bun, запасной через `npx`
Пример запроса к агенту
Запиши в Mulch ошибку: VACUUM внутри транзакции портит базу SQLite, решение — запускать VACUUM вне транзакцииОграничения
- Агент сам решает, когда вызывать `ml record`. Правило записи закрепляют в AGENTS.md или CLAUDE.md, фрагмент готовит `ml onboard`.
- Записи лежат открытым текстом в git, поэтому секреты и персональные данные в них не попадают.
- Устаревание определяют по числу коммитов в привязанных файлах и по сроку жизни записи, смысл утилита не проверяет.
- Основной путь установки идет через Bun, запасной через `npx @os-eco/mulch-cli`.
Как отключить. Уберите из настроек агента хук, который добавила команда `ml setup claude`. Если опыт больше не нужен, удалите папку `.mulch/`. Пакет удаляют тем менеджером, которым его ставили.
Частые вопросы
Где Mulch хранит опыт?
В `.mulch/expertise/` в корне репозитория: файл JSONL на каждый домен, одна запись на строку. Папку отслеживает git, а команда `ml sync` проверяет, индексирует и коммитит изменения.
Как подключить Mulch к Claude Code?
Выполните `ml init`, затем `ml setup claude`: команда ставит хук, который обслуживает `ml hook`. Фрагмент правил для CLAUDE.md выдает `ml onboard`.
Сколько токенов занимает вывод `ml prime`?
По умолчанию индекс ограничен 4000 токенов. Флаг `--budget` меняет лимит, а `--files` оставляет записи по нужным файлам.
Работает ли Mulch с Cursor и Codex?
`ml setup` ставит хуки для claude, cursor и codex. Полный список вариантов выводит `ml setup --list`.
Как найти устаревшие записи?
`ml stale` показывает записи, у которых привязанные файлы изменились минимум в пяти коммитах, пропали или пережили срок жизни без подтверждений. `ml prune` отправляет такие записи в архив.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЗадачи, документы, спецификации и решения проекта лежат файлами Markdown в репозитории, а агент читает их через CLI и MCP
Хартия на 2,4 КБ для CLAUDE.md и три скилла по вызову: агент проверяет результат и ждет подтверждения перед необратимым
CLI разбирает репозиторий шестифазным конвейером моделей и пишет AGENTS.md или CLAUDE.md; ведет планы ExecPlan с вехами.
Больше двадцати скиллов для кодовых агентов: MCP и хуки, режим плана, протокол багфикса, промпты и защитный хук для bash
Библиотека из 30 с лишним скиллов-инструкций для кодинг-агентов: от плана и сборки до проверки, защиты от галлюцинаций и выкладки
Граф кода и память проекта в одной программе на Rust: агент получает выдержки из файлов со ссылкой на строки
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Mulch (эта карточка) | нет | 339 | ||
| Beads | нет | 28 694 | трекер задач с графом зависимостей на Dolt, Mulch хранит накопленные знания | |
| agent-memory | нет | 4 315 | Markdown как источник истины и индекс SQLite, у Mulch записи JSONL по типам | |
| ByteRover CLI | да | API-ключ | 4 946 | слой памяти brv с версиями как в git и MCP-сервером |
Коротко о README
README начинается с мысли, что агент каждый раз стартует с нуля, и с оговорки, что Mulch пассивен. Дальше идут установка, быстрый старт, таблица из трех десятков команд, форматы вывода, устройство папки `.mulch/` и типы записей.