Machinist CLI
Сервер на Go гоняет Claude Code или Codex на вашей машине или в Kubernetes и сдает работу через «pull request» после ревью
- 529 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент пишет код и открывает «pull request» от имени GitHub App в выбранных репозиториях
- Команды агента выполняются на вашем хосте под входом в Codex или Claude Code
- Необязательное обслуживание репозитория может сливать правки документации без человека
Установка
- Работает в
Ручная установка
git clone https://github.com/owainlewis/machinist.git && cd machinist && go build -o ./bin/machinist ./cmd/machinistНужны Go 1.26.6, Git, GitHub CLI и авторизованный CLI агента. Дальше ./bin/machinist init и ./bin/machinist start, затем подключение GitHub App в интерфейсе.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент пишет код и открывает «pull request» от имени GitHub App в выбранных репозиториях
- Команды агента выполняются на вашем хосте под входом в Codex или Claude Code
- Необязательное обслуживание репозитория может сливать правки документации без человека
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Machinist запускает кодовых агентов на инфраструктуре, которую вы контролируете: на своем компьютере, виртуальной машине или в Kubernetes. Задачу ставят текстом или ссылкой на задачу GitHub, на выходе получают «pull request» либо прямой ответ, если менять файлы не просили. Агент работает через собственный CLI, Codex или Claude Code. Управляющий сервер на Go и интерфейс на React отслеживают выполнение, согласования, ревью и доставку. Стандартный конвейер состоит из разбора задачи, необязательной спецификации с согласованием, сборки и независимого ревью. Замечания возвращаются на сборку в тот же «pull request», до трех кругов исправлений. Режим одного агента ведет задачу до конца без отдельного ревьюера. Есть сохраненные автоматизации с расписанием cron, а после доставки Machinist следит за упавшими проверками и замечаниями и чинит их в той же задаче. В репозитории лежит скилл machinist. Он объясняет кодовому агенту, как завести задачу GitHub командой `gh issue create` и поставить задачу через `machinist run` или `machinist submit`. По правилам скилла агент «pull request» не сливает.
Для кого. Командам и одиночным разработчикам, которые ставят задачи агентам через GitHub и хотят получать проверенные «pull request» на своих серверах.
Подходит, если
- Очередь задач GitHub разбирается ночью: задача уходит агенту, утром ждет «pull request» с результатом ревью
- Регламентную работу надо гонять по расписанию: разбор задач и «pull request», правки документации
- Код нельзя отдавать облачному сервису, и агент должен работать на своей виртуальной машине или в кластере
- Проверки упали на «pull request» агента, и починка должна идти в той же задаче
- Спецификацию до начала сборки согласует человек
Не подходит, если
- Хватает одного запуска агента в терминале: сервер, GitHub App и интерфейс избыточны
- Нужен облачный сервис без установки: Machinist собирается из исходников и управляется вами, облачного аккаунта у него нет
- Работа идет вне GitHub: триггеры, задачи и доставка построены на GitHub App и `gh`
- Нужен провайдер кроме Codex и Claude Code: в Kubernetes поставляется только вход по подписке Codex
Пример запроса к агенту
Заведи задачу про падающий тест логина и поставь задачу Machinist: нужен «pull request» с исправлением и независимым ревьюОграничения
Установка идет сборкой: нужны Go 1.26.6, Git, GitHub CLI и авторизованный CLI агента на хосте выполнения; публикации ведутся через GitHub App, который надо подключить. В режиме нативных агентов нет обязательного согласования спецификации и отдельной копии репозитория только для чтения при ревью, замечания дочерних агентов носят совещательный характер. Для Kubernetes поддержан вход по подписке Codex, другие провайдеры не заявлены. Состоянием владеет один управляющий сервер на SQLite: устаревшую копию с ноутбука не держат рядом с облачной.
Как отключить. Остановите управляющий сервер, удалите собранный файл `bin/machinist` и отзовите доступ GitHub App в настройках организации. Скилл убирается удалением папки `skills/machinist` из проекта агента. Состояние лежит в приватном каталоге выполнения: перед удалением сохраните его вместе со снимком SQLite.
Частые вопросы
Как запустить Machinist локально?
Склонируйте репозиторий, соберите `go build -o ./bin/machinist ./cmd/machinist`, выполните `./bin/machinist init` и `./bin/machinist start`. Откройте адрес из вывода, подключите GitHub App, выберите проект и агента и проверьте ответ PONG.
Нужна ли подписка или облачный аккаунт Machinist?
Облачный аккаунт не нужен. Агент работает через собственный CLI, Codex или Claude Code, под вашей авторизацией на хосте выполнения.
Что происходит, если проверки упали или пришло замечание?
Machinist следит за доставленными «pull request»: упавшими проверками, доверенными замечаниями и подтвержденными слияниями. Починка идет в той же задаче и в том же «pull request».
Может ли Machinist сам слить «pull request»?
Обычно слияние решает человек. Необязательное обслуживание репозитория сливает узкий класс низкорисковых правок документации после независимого ревью и при защите ветки. Одиночные агенты и посторонние «pull request» под него не подпадают.
Где выполняются задачи?
На хосте управляющего сервера, на виртуальной машине с собственным рабочим процессом или в Kubernetes, где каждая попытка идет отдельным Job под gVisor.
Что делает скилл machinist?
Учит агента ставить задачи: заводит задачу GitHub, запускает `machinist run` или `machinist submit` и отчитывается о статусе. Метка `machinist:requested` на задаче GitHub передает ее в очередь, если настроен GitHub-триггер.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОркестратор для Claude Code, Codex и Gemini CLI: сценарии на YAML повторяются, пока проходят ваши проверки
Self-hosted панель для управления несколькими агентами: постановка задач, обзор прогонов, учет трат и подключение по MCP, CLI или REST
Подключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
CLI, который прогоняет Claude Code, Codex, OpenCode и другие агенты циклом по списку задач или PRD, пока все не будет сделано
CLI, который берет тикеты из GitHub, Linear или Jira, пишет код через Claude Code и открывает запрос на слияние для вашего ревью
apra-fleet по MCP управляет флотом ИИ-агентов на разных машинах и моделях и ведет многочасовые рабочие процессы
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Machinist (эта карточка) | нет | 529 | ||
| Ralph Orchestrator | нет | не нужна | 3 194 | гоняет разных агентов по циклу до готовности задачи, без GitHub App и ревью в «pull request» |
| CLI Agent Orchestrator | нет | 1 515 | супервизор раздает задачи специалистам-агентам, доставки через GitHub нет |
Коротко о README
Описание начинается с идеи: агенты работают на вашей инфраструктуре, GitHub служит входом и выходом. Дальше идут быстрый старт, запуск задачи, автоматизации, таблица целей выполнения (локально, ВМ, Kubernetes) и перечень руководств по настройке, развертыванию на ВМ, Kubernetes и GKE.