OysterWorkflow — плагин
Плагин Codex и MCP-мост к приложению, которое записывает вашу работу на компьютере и строит из нее граф шагов для агента
- 175 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Приложение записывает экран, видимый текст, клики и ввод с клавиатуры, а при голосовых пояснениях еще и микрофон, и в записи могут оказаться пароли и чужие данные
- Агент выполняет шаги сценария в реальных программах: отправляет ответы, правит данные, работает с почтой и браузером
Установка
- Работает в
Ручная установка
codex plugin marketplace add ShuxinYang111/oysterworkflowЗатем выполните codex plugin add oysterworkflow@oysterworkflow и начните новую задачу. Приложение OysterWorkflow должно быть установлено и запущено.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Приложение записывает экран, видимый текст, клики и ввод с клавиатуры, а при голосовых пояснениях еще и микрофон, и в записи могут оказаться пароли и чужие данные
- Агент выполняет шаги сценария в реальных программах: отправляет ответы, правит данные, работает с почтой и браузером
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OysterWorkflow состоит из настольного приложения и плагина для агента. Приложение наблюдает за работой на компьютере: состояние экрана, видимый текст, клики мыши, ввод с клавиатуры, контекст программ и, по желанию, голосовые пояснения. Из записи оно выделяет цели, ветвления, предпочтения, исключения, шаги восстановления и условия завершения, а результат оформляет как граф процесса с ревизиями, который можно проверить глазами. Плагин связывает этот граф с агентом. Для Codex он ставится двумя командами и запускает локальный мост по STDIO. Мост сам находит динамический порт приложения через файл подключения, доступный только владельцу, поэтому порт и токены вручную не настраиваются. Для Claude, OpenClaw, Hermes и других клиентов MCP в README есть готовый промпт: агент сам добавляет упакованный запуск `oysterworkflow-mcp` как локальный сервер. Состояние запуска хранит OysterWorkflow: граф, ревизию, переходы, лимиты повторов. Реальные действия в программах выполняет сам агент теми инструментами, которые установлены и разрешены в нем. Среди инструментов моста `search`, `fetch`, `prepare_workflow_run`, `get_workflow_run`, `advance_workflow_run` и `cancel_workflow_run`.
Для кого. Тем, кто повторяет на компьютере одни и те же многошаговые процессы, например разбор входящих заявок с ответами, и хочет один раз показать их, а потом поручить Codex.
Подходит, если
- Рутина идет через несколько программ, и словами ее описывать дольше, чем один раз выполнить на записи
- В процессе есть развилки и исключения, которые обычный макрос не переживает
- Результат записи надо просмотреть как граф шагов и поправить до запуска агентом
- Агент уже работает в Codex на Mac, и нужно дать ему повторяемый сценарий с остановкой на согласование
- Один и тот же сценарий нужно запускать из разных клиентов MCP через локальный мост
Не подходит, если
- Нет компьютера Mac на Apple Silicon: плагин для Codex и новый граф шагов пока требуют такой компьютер, сборка для Windows более ранняя
- Коммерческое использование: код настольного приложения под PolyForm Noncommercial, для бизнеса нужна отдельная лицензия
- На экране бывают чужие данные, пароли или рабочие секреты, а записывать их нельзя
- Сценарий должен запускаться без приложения: плагин работает только пока OysterWorkflow запущен
Пример запроса к агенту
Используй OysterWorkflow и запусти сценарий «Разобрать входящие заявки и подготовить ответы»Ограничения
- Плагин и последняя версия графа шагов требуют macOS на Apple Silicon. Сборка для Windows x64 ранняя, версия 0.1.0.
- Для записи нужны разрешения на запись экрана, универсальный доступ и мониторинг ввода, а для голосовых пояснений еще микрофон.
- Приложение должно оставаться запущенным на время выполнения, а все программы сценария должны быть доступны самому Codex.
- Лицензия смешанная: ядро под Apache-2.0, код настольного продукта под PolyForm Noncommercial 1.0.0. Перед повторным использованием файлов проверяйте `LICENSING.md`.
Как отключить. В Codex отключите плагин oysterworkflow в списке плагинов и при желании уберите marketplace ShuxinYang111/oysterworkflow. Для других клиентов удалите локальный сервер `oysterworkflow` из настроек MCP. Запись остановите и выйдите из OysterWorkflow, а разрешения на экран и ввод отзовите в системных настройках macOS.
Частые вопросы
Как подключить OysterWorkflow к Codex?
Установите приложение и запустите его, затем выполните `codex plugin marketplace add ShuxinYang111/oysterworkflow` и `codex plugin add oysterworkflow@oysterworkflow`. Начните новую задачу в Codex и попросите запустить сценарий по названию.
Работает ли это с Claude Code и другими агентами?
Да, через локальный MCP-мост. В README есть промпт, который агент выполняет сам: находит `oysterworkflow-mcp` в пакете приложения и добавляет его как stdio-сервер. На macOS путь обычно такой: `/Applications/OysterWorkflow.app/Contents/Resources/mcp/oysterworkflow-mcp`.
Что записывает приложение?
Состояния экрана, видимый текст, действия мыши и клавиатуры, контекст программ и по желанию голос. Для этого нужны разрешения на запись экрана, универсальный доступ и мониторинг ввода. В обращениях в поддержку не прикладывайте пароли, данные клиентов и закрытые адреса.
Можно ли использовать OysterWorkflow в коммерческих проектах?
Ядро под Apache-2.0 разрешает это, но код настольного приложения распространяется по PolyForm Noncommercial 1.0.0. Для коммерческого использования приложения нужна отдельная лицензия от авторов.
Какие инструменты отдает мост?
Шесть: `search`, `fetch`, `prepare_workflow_run`, `get_workflow_run`, `advance_workflow_run` и `cancel_workflow_run`. Первые два ищут и читают сценарии, остальные готовят запуск, показывают его состояние, двигают по шагам и отменяют.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныОфициальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Open Dynamic Workflow превращает повторяемые задачи агентов в проверяемые скрипты для Codex, Gemini, Cursor и других CLI.
Self-hosted панель для управления несколькими агентами: постановка задач, обзор прогонов, учет трат и подключение по MCP, CLI или REST
Плагин от команды n8n: 13 скиллов и встроенное MCP-подключение учат Claude Code и Codex собирать, править и проверять воркфлоу n8n
MCP-сервер для n8n: ассистент создает, запускает и удаляет воркфлоу через API, смотрит запуски и теги и просит отчет аудита безопасности
Плагин для Claude Code и CLI для научных установок: агент ищет каналы управления и пишет в железо только после одобрения.
Коротко о README
README объясняет идею опыта работы для агента и в три шага показывает путь от записи до запуска. Дальше идут подключение к Codex и к другим клиентам MCP, загрузка приложения для macOS и Windows и описание смешанной лицензии. Заканчивается страница ссылками на дорожную карту и правилами обращений.