Prax CLI
Python-среда для работы агентов: границы задачи, независимая проверка результата и сохраненная передача между сессиями
- 272 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Исполнитель Claude или Codex правит файлы репозитория и запускает тесты, а защита замечает отклонения на границах, но не откатывает побочные эффекты
- Установщик для Claude Code меняет пользовательский каталог `~/.claude`, где лежат ваши настройки
Установка
- Работает в
Ручная установка
python3 -m venv .venv && .venv/bin/python -m pip install -e .Из клона репозитория `git clone https://github.com/ChanningLua/prax-agent.git`. Проверка без запросов к модели: `.venv/bin/prax --version`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Исполнитель Claude или Codex правит файлы репозитория и запускает тесты, а защита замечает отклонения на границах, но не откатывает побочные эффекты
- Установщик для Claude Code меняет пользовательский каталог `~/.claude`, где лежат ваши настройки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Prax запускает работу агента внутри заданных границ и оставляет доказательства результата. Команда `prax shift` принимает замороженную задачу из `.prax/task.json`: цель, редактируемые репозитории и ветки, проверку приемки и общий бюджет попыток. Если проверка уже проходит, исполнитель не нужен. Иначе Claude или Codex делает ограниченное число попыток правки, а независимый проверяющий решает, принята ли работа. Команда `prax shift plan` проверяет контракт и состояние репозитория, но не запускает ни тесты, ни исполнителя. Результаты ложатся в `.prax/harness-runs/<task-id>/`. Режим `verification` один раз запускает тесты проекта через мост и разделяет пройденные, упавшие, заблокированные и не запущенные случаи. Кроме этого, Prax содержит собственного терминального агента с командами `prax prompt` и `prax repl`, поддержкой навыков, подагентов и MCP-инструментов. Для Claude Code пакет приносит скиллы, команды, правила и хуки, для Codex ставит проектный скилл `prax-shift`. Есть рецепты для статей, исследований и заметок к релизам.
Для кого. Разработчикам, которые передают агенту ограниченную задачу в репозитории и хотят получить результат с независимой приемкой, журналом и бюджетом попыток.
Подходит, если
- Баг в парсере пустого ввода надо поручить агенту в пределах одной папки с замороженными тестами и лимитом в три попытки
- Нужно один раз прогнать сквозные тесты и получить отдельный учет пройденных, упавших и заблокированных случаев
- Работу надо приостановить и продолжить позже без потери бюджета и накопленного состояния
- Исполнителем должен быть Claude или Codex, а приемку надо отдать независимому тесту проекта
Не подходит, если
- Нужна песочница операционной системы: Prax ее не создает, защита репозитория замечает изменения на границах, но не отменяет побочные эффекты
- Задача открытая, без проверки приемки: контракт требует тест или другой проверяемый критерий
- Нужен полностью автономный бесконечный список задач: бюджет и остановка заданы явно, а расписание продолжает известную задачу
- Нужна установка на Windows: инструкция рассчитана на macOS и Linux
Пример запроса к агенту
Используй Prax Shift, чтобы исправить баг с пустым вводом в парсере: правки только в папке parser, тесты не менять, три попытки, коммитов нет, сначала покажи планОграничения
- README относится к ветке `main`, опубликованный пакет может отставать, поэтому для описанных возможностей берут исходники.
- Нужен Python 3.10 на macOS или Linux. Проверка Codex-установки работает только на macOS и зависит от версии Codex CLI.
- Установщик для Claude Code меняет пользовательский каталог `~/.claude`, в отличие от проектной установки для Codex.
- Автор называет тесты и адаптеры доверенным исполняемым кодом, а защиту репозитория не считает песочницей.
- Последний коммит датирован сентябрем 2026 года.
Как отключить. Для проектной установки Codex удалите файлы `.codex/skills/prax-shift/SKILL.md` и `.prax/codex-install.json`, а каталог `.prax/venv` можно стереть целиком. Для Claude Code верните изменения в `~/.claude`, внесенные установщиком, и удалите клон репозитория.
Частые вопросы
Как установить Prax?
Клонируйте репозиторий и выполните в виртуальном окружении `python -m pip install -e .`, затем проверьте `.venv/bin/prax --version`. Нужны Python 3.10 и macOS или Linux, Node.js не нужен.
Что делает команда prax shift plan?
Она проверяет контракт задачи и источник репозитория, но не запускает тесты, исполнителя или расписание. Так можно увидеть, что Prax собирается сделать, до одобрения запуска.
Какие агенты могут быть исполнителями?
Claude и Codex выбираются в профиле репозитория через поле `worker`. Codex по умолчанию работает в режиме `workspace-write`, Claude в режиме `dontAsk`, и защита у них не равнозначна.
Чем режим verification отличается от shift?
Режим `verification` запускает тесты один раз без исполнителя, повторов и возобновления. `shift` вокруг задачи кода ведет цикл правки с проверкой после каждой попытки.
Защищает ли Prax от опасных команд?
Нет, это не песочница операционной системы. Защита репозитория обнаруживает отклонения на границах задачи, а тесты и адаптеры остаются доверенным исполняемым кодом.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI, хуки и скиллы для долгой работы Claude, Codex и Pi: задачу ведут issue и PR, а на ревью приходит PR с проверками
Больше двадцати скиллов для кодовых агентов: MCP и хуки, режим плана, протокол багфикса, промпты и защитный хук для bash
Задачи, документы, спецификации и решения проекта лежат файлами Markdown в репозитории, а агент читает их через CLI и MCP
CLI дает шести кодовым агентам общий процесс: контекст проекта, более 80 скиллов, проверки и продолжение задач между сессиями
Скиллы команды Codely ведут работу агента по фазам: план в файле или GitHub Issues, ревью после каждой фазы и аккуратный коммит
Утилита и скилл, с которыми Claude Code раздает задачи субагентам Claude, Codex или OpenCode в отдельных Git worktree
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Prax (эта карточка) | нет | 272 | |
| repo-harness — рабочий процесс агентов Claude, Codex и Pi в репозитории | нет | 435 | выполняет похожий цикл проверки, но без замороженного контракта задачи и бюджета попыток |
| Ralph TUI | нет | 2 461 | гоняет агента по списку задач в терминале, без независимой приемки результата |
Коротко о README
README рассказывает о запуске агентской работы с явными границами, повторяемыми процессами и результатом с доказательствами. Он объясняет три слоя архитектуры, установку, точки входа для собственного агента, Codex и Claude Code, команды Prax Shift и режим проверки, а в конце перечисляет известные ограничения.