Английский · Испанский · Французский · Немецкий · Японский · Итальянский · Турецкий · Португальский (Бразилия)

Этот перевод может отставать от английского README.

Ваш ИИ забывает. Pathrule помнит.

Open-source-слой знаний для coding-агентов. Pathrule сохраняет знания, полученные в ходе работы над проектом, в виде воспоминаний, правил и навыков, привязанных к путям в коде. Перед началом работы он передаёт Claude Code, Codex, Cursor, GitHub Copilot и Windsurf только то, что нужно для текущей задачи.

PathruleBench, 2000 записей: стоимость цепочки ниже на 55 % · входных токенов меньше в 2,7 раза · пройдено 97 % проверок памяти · результаты

Сайт · Документация · Быстрый старт · Бенчмарки · Умнее со временем · История изменений

Один и тот же запрос, один и тот же агент. Справа хук Pathrule передаёт три заметки для apps/web/dashboard до того, как агент напишет первую строку.

Работает с Claude Code · Codex · Cursor · GitHub Copilot · Windsurf · любым MCP-клиентом

Быстрый старт

Node.js 22.14.0 или новее, macOS, Linux или Windows.

npm i -g @pathrule/cli
pathrule setup --local    # kein Konto: das Wissen bleibt auf diesem Rechner
pathrule doctor           # zeigt, was jeder Agent bekommt

Перезапустите агента. Начиная со следующей сессии он будет получать заметки для пути, с которым собирается работать, и добавлять новые по ходу работы.

Другие варианты запуска	Команда	Для чего подходит
Расширение для VS Code	code --install-extension Pathrule.pathrule-vscode	Знания доступны прямо рядом с кодом. Marketplace и Open VSX.
Плагин для Claude Code / Codex	/plugin marketplace add pathrule/pathrule · codex plugin marketplace add pathrule/pathrule	Установка прямо в агенте. Перед внесением изменений мастер настройки показывает план.
Плагин для Cursor	Cursor Marketplace → Pathrule	Те же хуки, MCP и навыки в Cursor.
Плагин для Gemini CLI / OpenCode	gemini extensions install https://github.com/pathrule/gemini-cli-extension · opencode plugin @pathrule/opencode --global	Та же настройка для Gemini CLI и OpenCode.
Любой MCP-клиент	npx -y @pathrule/mcp	Для агентов без системы плагинов. Есть в официальном реестре MCP.
Локальная консоль	pathrule ui	Просмотр и редактирование знаний на 127.0.0.1. Без учётной записи.
Удалённый MCP	claude mcp add --transport http pathrule https://cloud.pathrule.io/mcp	Попробуйте, ничего не устанавливая. Без хуков и локального режима.
Сборка из исходного кода	pnpm install && pnpm cli:bundle	Участие в разработке Pathrule. См. docs/quickstart.md.

Объясните один раз

Coding-агенты начинают каждую сессию с нуля. Поэтому одну и ту же поправку приходится повторять изо дня в день, от агента к агенту:

День	Агент	Что вы написали
Пн	Claude Code	«используй наш api client, а не fetch»	1.
Вт	Claude Code	«ещё раз: api client, а не fetch»	2.
Ср	Codex	«мы используем api client»	3.
Чт	Cursor	«Я же говорил вчера. api client.»	4.
Пт	Claude Code	«API CLIENT. НЕ FETCH.»	5.

Пять сессий, три агента — ничего не запомнено. С Pathrule достаточно сказать один раз:

• Вы исправляете агента один раз, как обычно.

• Pathrule сохраняет это знание рядом с нужным кодом: воспоминание привязывается к features/, а не добавляется ещё одной строкой в файл, который агент должен читать в каждой сессии.

• Со следующей сессии это знают все агенты, независимо от того, какого из них вы запустите.

Только нужное

В рабочей области могут накопиться сотни заметок. Агенту, который работает с features/orders, нужны лишь четыре из них.

Знания отбираются с учётом пути, области действия и релевантности, а затем укладываются в бюджет каждого промпта. Обязательные правила никогда не урезаются из-за нехватки места. Если что-то не помещается, Pathrule перечисляет это по заголовкам, чтобы агент мог запросить недостающие сведения. Если в промпте упоминается функция или тип, хук также указывает агенту файл и строку, где они определены (JS/TS, Python, Go).

Три типа знаний

Тип	Содержание	Пример для features/
Воспоминание	Решения, подводные камни и инциденты в виде краткого Markdown-текста.	«Используй api client. Он отвечает за аутентификацию и повторы запросов.»
Правило	Требования, которым агент обязан следовать; они имеют приоритет над рекомендациями.	«Загружай данные через React Query.»
Навык	Повторно используемые процедуры и контрольные списки, которые агент может выполнять.	«Перед завершением работы запускай проверки.»

Три способа передать знания

Канал	Когда агент получает знания	Стоимость
Файлы правил, привязанные к путям	В начале сессии Claude Code читает собственную папку Pathrule .claude/rules/pathrule/; каждый файл применяется только к указанным в нём путям. Ваши CLAUDE.md и AGENTS.md остаются без изменений.	Кэшируются клиентом.
Хуки	До того, как агент приступит к работе: в начале сессии, при каждом промпте и при вызове инструментов для работы с файлами. Повторно отправляется только новый или изменившийся контекст.	Бюджет каждого промпта.
MCP get_context	Когда агент запрашивает контекст — в объёме, необходимом для задачи.	Доступно в любом MCP-клиенте.

Почему бы просто не использовать CLAUDE.md?

Файл CLAUDE.md целиком читается при каждом шаге, поэтому каждая заметка команды увеличивает стоимость каждой сессии. Pathrule передаёт каждому промпту только то, что нужно с учётом пути и задачи. Разница измерена в PathruleBench: один и тот же агент, те же промпты и те же скрытые проверки, при объёме знаний команды от 500 до 2000 записей.

При 2000 записях знаний команды	CLAUDE.md	Pathrule
Стоимость цепочки из 8 сессий	3,89–4,21 $	1,76–1,89 $
Входные токены на цепочку	11,8–12,5 млн	4,3–4,7 млн
Пройденные проверки памяти	89 %	97 %
Цепочки, прошедшие все проверки памяти	0 из 9	5 из 9
Выполнение привычки, названной один раз	78 %	97 %
Сохранение знаний, полученных после неудачной команды	33 %	78 %
Выполнение работы, заданной в каждом промпте	100 %	100 %

При росте базы знаний с 500 до 2000 записей стоимость цепочки с CLAUDE.md увеличивается на 89–98 %. С Pathrule она меняется в пределах от −1 % до +10 %. База знаний может расти, а расходы — нет.

Claude Code с claude-sonnet-5-5 для Python, Go и TypeScript; при 2000 записях — девять цепочек в каждой группе (по три на язык); результат каждой проверки определяется исполняемыми тестами, а не оценкой модели. В группе Pathrule использовалась open-source CLI из этого репозитория в локальном режиме: без облака и без модели.

Все условия, цепочки и проверки, а также инструкции по самостоятельному запуску → pathrule/benchmark

Чем дольше используется, тем умнее становится.

В первый день не нужны ни аккаунт, ни сеть, ни модель. Всё остальное основано на том, что вы и ваши агенты уже сделали в этом репозитории.

Когда	Что делает Pathrule	Где работает
День 0: основа	Хуки и локальный MCP-сервер подключаются к вашим агентам. Всё, что вы пишете, передаётся с учётом пути и в пределах заданного бюджета — через хуки и правила Claude Code для конкретных путей. Ваши собственные CLAUDE.md и AGENTS.md остаются без изменений.	Open Source, этот компьютер
Неделя 1: память	Решение, которое вы упоминаете в промпте («с этого момента…», «мы решили…»), сохраняется вашими словами. Урок из неудачной команды сохраняется один раз. Каждая заметка находится рядом с кодом, к которому относится, а повторно передаются только новые или изменённые сведения.	Open Source, этот компьютер
Месяц 1: ваши привычки	Упомянутое вами предпочтение хранится в отдельном локальном файле. Если вы сказали о нём вскользь, оно подождёт; если повторили в другой сессии — будет передаваться каждому агенту. Предпочтение, которое вы назвали постоянным, применяется сразу. Правило проекта всегда важнее личного.	Open Source, этот компьютер
Месяц 3: масштабирование	Даже если заметок тысячи, размер сессии остаётся прежним: корневой файл правил занимает около 6000 символов, а остальное добавляется к каждому промпту. Предложение с указанием расположения кода помечается как (as of writing): если кто-то в команде переместит файл, агент найдёт код по новому пути. Если изменение записывает значение, которое уже заменено более новым решением, хук приводит это решение прямо в нужном месте.	Open Source, этот компьютер
Если нужна команда	Одни и те же знания доступны на каждом компьютере и каждому участнику. В облачном рабочем пространстве модель дополнительно анализирует промпты, в которых правила Pathrule на уровне предложений ничего не нашли, и сохраняет вашими словами то, что должно действовать постоянно. Оплата производится AI Credits.	Pathrule Cloud, по желанию

На вашем компьютере модель не запускается. Всё до командного уровня — это CLI с открытым исходным кодом, тот же способ работы, который измерялся в приведённом выше бенчмарке.

Смените агента. Сохраните знания.

Агент	До начала работы	Файл инструкций	MCP
Claude Code	Хуки, включая Prompt-Hook	Собственная папка Pathrule .claude/rules/pathrule/	Локально или удалённо
Codex	Хуки, включая Prompt-Hook	—	Локально или удалённо
Cursor	—	—	Локально
GitHub Copilot	—	—	Локально
Windsurf	—	—	Локально
Любой MCP-клиент	—	—	Локально или удалённо

Больше не нужно поддерживать ещё один файл правил

	Один файл правил	Pathrule
Создание и обновление	Вручную	Пополняется по мере работы вас и ваших агентов
Доступность	Один инструмент на файл	Каждый подключённый агент
Передача	Всё содержимое в каждой сессии	Только то, что нужно для конкретного пути и задачи
Изменения	Когда кто-то редактирует файл	Знания версионируются; новые заменяют устаревшие

Оставьте свои CLAUDE.md и AGENTS.md: Pathrule их не меняет. Остальные сведения он передаёт с учётом пути и задачи — в отличие от одного файла, который не может охватить всё.

Что входит в этот репозиторий

Это основа Pathrule с открытым исходным кодом. Она работает без аккаунта и сетевого сервиса: хранение, поиск и ранжирование, MCP-сервер, хуки, цикл обучения и CLI.

Компонент	В этом репозитории	Лицензия
Основа: протокол, Agent IR, локальное хранилище знаний, хост, MCP-сервер, CLI, клиент Pathrule Cloud, интеграции с агентами, Local Console, расширение VS Code	Да	Apache-2.0
Pathrule Cloud: командные рабочие пространства, синхронизация, веб-консоль, удалённый MCP, облачный модельный уровень	Нет	Проприетарная

11 пакетов

протокол · agent-ir · core · интеграции · mcp · host · ui · local-console · cloud · cli · vscode

pnpm install
pnpm typecheck      # alle Pakete
pnpm test           # die Tests jedes Pakets
pnpm build          # der npm-Build jedes Pakets

Ваш код остаётся вашим

• Исходный код никогда не загружается автоматически.

• Для локального режима не нужен аккаунт, в нём не запускается модель, а открытая CLI не отправляет телеметрию.

• Ваш агент продолжает использовать выбранного вами поставщика моделей. Pathrule — это не модель, не агент и не IDE.

• Pathrule Cloud можно не использовать. После входа в аккаунт сервис хранит ваши знания и использует промпт, чтобы упорядочивать их; его модельный уровень может прочитать промпт, чтобы найти решение, которое должно действовать постоянно.

Сообщество

Участникам проекта

Как внести вклад (подтверждение DCO) · Кодекс поведения · Сообщить об уязвимости · Получить помощь · Правила использования товарных знаков

Лицензия

Apache-2.0. См. LICENSE и NOTICE. На название и логотип Pathrule лицензия Apache-2.0 не распространяется.

pathrule.io · Документация · Pathrule Cloud