Potpie CLI
Potpie строит граф контекста по коду, истории и решениям команды и подключает его к Codex или Claude Code через набор скиллов
- 5 797 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Индексирует код и заметки проекта в локальное хранилище
- Запускает локальный демон и меняет конфигурацию агента
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/potpieОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Индексирует код и заметки проекта в локальное хранилище
- Запускает локальный демон и меняет конфигурацию агента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Potpie — CLI, который превращает репозиторий и процесс разработки в граф контекста для агентов. Он индексирует код, структуру, решения, историю и знания команды, чтобы агент отвечал на вопросы, планировал изменения и разбирал сбои с учетом проекта. Команда `potpie setup` создает локальную конфигурацию, хранилище, демон, рабочий граф по умолчанию и скиллы для выбранной среды. В пакет входят скиллы для хронологии изменений, базовой картины репозитория, инфраструктуры, предпочтений проекта и приема источников. Граф открывает команда `potpie ui`.
Для кого. Командам, у которых агент теряет контекст в большом репозитории и не знает прошлых решений, инфраструктуры и договоренностей.
Подходит, если
- Агент выдает правку, которая противоречит решению, принятому полгода назад.
- Перед рефакторингом нужна хронология изменений модуля и причины каждого.
- В проект приходит новый разработчик, и агент должен объяснить структуру и инфраструктуру.
- Сбой разбирают с опорой на прошлые инциденты и накопленные заметки.
- Требования и документы лежат в Markdown, PDF и таблицах, и агенту нужен к ним доступ.
Не подходит, если
- Проект маленький, и вся история помещается в обычный контекст агента.
- Код и заметки нельзя индексировать даже локально.
- Нужен готовый облачный сервис без демона на своей машине.
Пример запроса к агенту
Используй Potpie для этого репозитория: покажи хронологию изменений модуля оплаты и назови решения, которые нельзя ломать.Ограничения
Установка запускает локальный демон и хранилище, поэтому на машине появляются постоянные процессы и данные. Мастер `potpie setup` сам выбирает интеграции и среду по вашим ответам: проверьте, какие источники вы подключили. Качество ответов зависит от того, что проиндексировано. Для установки нужен Python и `uv` или `pip`. Версия и совместимость с конкретным агентом описаны в документации проекта. Ответы агента остаются его ответами: сверяйте их с кодом.
Как отключить. Остановите демон и удалите пакет через `uv tool uninstall potpie`. Скиллы из каталога скиллов агента, локальную конфигурацию и хранилище графа удалите вручную.
Частые вопросы
Как установить Potpie?
Выполните `uv tool install potpie` или `python3 -m pip install --user potpie`, затем `potpie setup`. Мастер создаст конфигурацию, демон, граф по умолчанию и скиллы для выбранной среды.
Нужно ли запускать прием данных вручную?
Нет. CLI регистрирует источники, а настроенный агент сам загружает или обновляет контекст, когда этого требует задача.
Как посмотреть граф?
Команда `potpie ui` открывает обозреватель графа в браузере.
Какие скиллы ставятся?
Набор включает `potpie-change-timeline`, `potpie-repo-baseline`, `potpie-infra-architecture`, `potpie-project-preferences`, `potpie-debug-memory`, `potpie-source-ingestion` и скиллы для ресурсов в Markdown, PDF и таблицах.
Что делать, если мастер выбрал не ту среду?
Запустите `potpie setup` снова и выберите нужную среду агента.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCodexPotter гоняет Codex по кругу с чистым контекстом, пока код не совпадет с целью, и заменяет встроенную команду /goal.
Набор процесса для агентов: роутер скиллов, память проекта в папке DEV и проверка результата перед словом «готово».
Память для агентов на графе знаний: плагины для Claude Code и Codex, MCP-сервер и Python-библиотека
Личная конфигурация агента Pi с четырьмя командами: план, задачи, исполнение и ревью через файлы сессии в Markdown.
Слой памяти и координации для кодовых агентов: спецификации и задачи лежат в git, а агенты работают параллельно
Compozy ведет сессии Claude Code, Codex и Cursor: доска задач, проверки по расписанию, вызов человека только по делу.
Коротко о README
Установка в два шага: пакет из PyPI и мастер `potpie setup`. После него выбранная среда уже знает про Potpie.