Cheap Labor

Аннотация

Cheap Labor существует потому, что использование Codex — это ограниченный пул — и большая часть того, что делает кодинг-агент, — это не написание кода. Чтение файлов, исследование репозитория, планирование и ревью диффов — всё это сжигает лимит Codex, не написав ни строчки кода.

Затем пришло ключевое осознание: использование ChatGPT и Codex учитывается отдельно — два независимых лимита. Поэтому мы решили разделить работу: ChatGPT выполняет всё мышление за свой счёт, а Codex тратится только на реальную реализацию.

В этом вся идея — локальный MCP-сервер, соединённый через Secure MCP Tunnel: ChatGPT в вебе управляет Codex CLI на вашей машине, работающим с вашим локальным репозиторием, по одному триггеру @cheap-labor.

Технологии

Cheap Labor построен на намеренно небольшом, кроссплатформенном стеке:

• Среда выполнения: Node.js (>= 20) — среда выполнения мостового сервера

• Язык: TypeScript — весь код моста

• Протокол: MCP SDK (@modelcontextprotocol/sdk) — stdio MCP-сервер + клиент

• Валидация: zod — схемы аргументов инструментов

• Исполнитель: Codex CLI (codex mcp-server) — порождаемый дочерний MCP-клиент для исследования и реализации

• Подключение: Secure MCP Tunnel (tunnel-client) — приватный, только исходящий канал между ChatGPT web и локальным сервером

Related MCP server: Kontrol

Предварительные требования

• macOS или Linux с Node.js >= 20 + npm

• git

• Платная учётная запись ChatGPT с режимом разработчика

• Codex CLI, выполнен вход (codex login)

• tunnel-client — устанавливается во время настройки: macOS через Homebrew; Linux через релизы GitHub (бинарь linux-amd64/arm64) в вашем PATH

• Secure MCP Tunnel + runtime API key с платформы OpenAI (установщик укажет вам нужные страницы)

Установка

Перейти к: 1. Клонирование и установка → 2. Использование

1. Клонируйте репозиторий и перейдите в него:

   git clone https://github.com/psrisuphan/cheap-labor.git
   cd cheap-labor

2. Запустите установщик — он установит зависимости, соберёт мост, запишет ваш профиль туннеля, проверит все 23 инструмента и проведёт вас через подключение приложения к ChatGPT web:

   ./scripts/install.sh

Использование

1. Запустите туннель — держите его включённым, пока пользуетесь cheap-labor:

   ./scripts/tunnel.sh start    # stop: ./scripts/tunnel.sh stop

2. Откройте новый чат ChatGPT и введите @cheap-labor — то же имя приложения, которое вы добавили из меню инструментов, — затем укажите проект.

3. Подтвердите каталог проекта, когда вас спросят — сессия активирована.

Удаление

./scripts/uninstall.sh

Удаляет всё, до чего может дотянуться скрипт: устаревшую регистрацию MCP, демон туннеля, состояние .codex-bridge/ в каждом инициализированном проекте, профиль туннеля и сохранённый API-ключ, а также артефакты сборки. Три запроса (нажмите Enter для рекомендуемого ответа, n — чтобы оставить). После этого выводится руководство по ручной очистке для того, до чего можете дотянуться только вы: подключение приложения ChatGPT, туннель Platform, runtime API key и папка проекта.

Как это работает

Мост находится в спящем режиме, пока не активирован. В спящем режиме сервер отдаёт только двухстрочное уведомление «игнорируйте эти инструменты» в качестве своих instructions, поэтому несвязанные запросы обрабатываются без того, чтобы мост вообще рассматривался. Полные правила рабочего процесса находятся в возвращаемом payload инструмента init и попадают в разговор только после активации.

Триггер — это сам вызов — никакого мониторинга промптов, никакого синтаксиса тегов, никакого сканирования фраз:

1. Пользователь вызывает cheap-labor, вводя @cheap-labor. Это единственный триггер.

2. ChatGPT спрашивает, какой проект вам нужен, разрешает его (find_projects для нечётких имён, create_project для новых каталогов), подтверждает точный путь с вами, затем активирует сессию — init(project) (или create_project напрямую для совершенно нового каталога) и получает session_token.

3. Каждый другой инструмент отказывается работать без действительного session_token — жёсткая подстраховка, которая также блокирует случайное использование вне рабочего процесса.

Рабочий процесс

1. Активируйте сессию — @cheap-labor + подтвердите проект → init возвращает токен.

2. Поймите — git_status, list_tree, read_file, grep (всё бесплатно).

3. Спланируйте детально — ChatGPT записывает PLAN.md / SPEC.md / TASKS.md в папку .codex-bridge/ репозитория с помощью plan_write. План — это точные пошаговые инструкции: какие файлы создать/отредактировать, каким должно быть каждое изменение, какие команды выполнить и как проверить.

4. Мелкие правки, сделанные напрямую — write_file / edit_file обрабатывают изменения в одном файле бесплатно.

5. Делегируйте тяжёлую работу — implement передаёт план Codex, который буквально выполняет шаги, запускает сборки/тесты, чинит то, что сломалось, и возвращает IMPLEMENTATION COMPLETE.

6. Ревью — ChatGPT читает возвращённый git diff и отправляет точечные исправления обратно через тот же цикл.

Возможности

• Активация одним триггером: @cheap-labor в любом чате ChatGPT — единственный триггер; мост остаётся в спящем режиме (ноль внимания модели), пока его не вызовут — никакого мониторинга промптов, никакого синтаксиса тегов, никакого сканирования фраз.

• Выполнение с гейтом риска: команды классифицируются как read-only или рискованные; рискованная работа проходит через авто-ревью Codex и ваше вето.

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

• Кроссплатформенность: macOS и Linux, без публичных портов, только исходящий туннель.

Справочник по инструментам

Бесплатные инструменты моста (детерминированный локальный ввод-вывод, без затрат Codex):

Инструменты на базе Codex (тратят пул Codex):

Модель безопасности

• implement / deep_explore всегда передают явную песочницу (workspace-write / read-only) — никогда danger-full-access.

• Фиксированная модель Codex — каждый вызов Codex закрепляет gpt-5.6-luna с рассуждениями medium и выключенным Fast Mode, передаваемыми как переопределения в каждом вызове. Мост никогда не пишет в ~/.codex/config.toml. Единственное исключение: deep_explore принимает более мощную модель, но только после того, как вы подтвердите изменение в чате.

• Автоматически безопасные подтверждения — подтверждения shell-команд Codex отображаются как MCP-elicitation: команды только для чтения подтверждаются автоматически; всё рискованное (запись, сеть, изменения в git) отклоняется и протоколируется, чтобы ChatGPT передал это вам для наложения вето. Вето выполняется через codex_reply.

• run_command запускает исполняемые файлы напрямую (без shell). Рискованные команды передаются на автоматическую проверку Codex — полный доступ никогда не предоставляется, ничто рискованное не запускается без запроса.

• write_file только создаёт новые файлы; edit_file редактирует только существующие с помощью замены по точному совпадению (устаревшие или неоднозначные совпадения ничего не записывают); edit_pack выполняет операции пакетно — всё или ничего. Все они ограничивают размер и отклоняют бинарные файлы.

• Режим выпуска — checkpoint создаёт снимок HEAD + рабочего дерева (снимок автоматически делается перед каждым implement); rollback восстанавливает контрольную точку (это действие также можно отменить); git_commit выполняет локальный коммит с сообщением, одобренным пользователем. Push/pull/reset/rebase/checkout никогда не предоставляются.

• Инструменты моста отклоняют пути за пределами одобренной в сессии директории проекта.

• read_file / git_diff по умолчанию маскируют известные секретные паттерны.

Структура проекта

cheap-labor/
├── assets/                  # Logo / icons
├── scripts/                 # Installer, uninstaller, tunnel control, setup
│   ├── install.sh           # All-in-one installer
│   ├── uninstall.sh         # Clean uninstaller
│   ├── tunnel-setup.sh      # Writes the tunnel-client profile
│   ├── tunnel.sh            # start / stop / restart / status / logs the tunnel daemon
│   └── setup.mjs            # Prerequisite check
├── src/                     # Bridge MCP server
│   ├── index.ts             # Server entry, tool registration, server instructions
│   ├── safety.ts            # Project scoping, redaction, risk classification
│   ├── projects.ts          # Session approvals, ledger, find/create
│   ├── planstore.ts         # .codex-bridge/ I/O
│   ├── approvals.ts         # Auto-safe policy
│   └── tools/               # context, command, codexCommand, codex, deepExplore,
│                            # implement, edit, plans, ship
├── tests/                   # Node test suite
├── dist/                    # Build output (gitignored)
└── package.json

Тестирование

Чтобы запустить наборы модульных тестов:

npm run typecheck    # tsc --noEmit
npm test             # node --test (tsx)

Локальные данные и журналы

Cheap Labor хранит профиль туннеля, runtime API-ключ и журналы демона локально, вне директории проекта:

• macOS / Linux: ~/.config/tunnel-client/

Внутри этой директории вы найдёте:

• cheap-labor.yaml — профиль tunnel-client (содержит идентификатор туннеля).

• cheap-labor.key — runtime API-ключ, chmod 600, никогда не коммитится.

• cheap-labor.log — журнал демона туннеля.

Планы и файлы передачи (handoff) записываются в папку .codex-bridge/ каждого проекта во время выполнения (игнорируется git). Конфигурация и аутентификация самого Codex находятся в ~/.codex/.

Лицензия

Этот проект распространяется по лицензии MIT. Полный текст лицензии приведён в файле LICENSE.