zx CLI
zx, CLI для JavaScript-сценариев, экранирует аргументы внешних команд и объединяет их результаты через асинхронные вызовы.
- 45 844 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Сценарии запускают внешние команды с правами пользователя и могут менять доступные им файлы.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/zxОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сценарии запускают внешние команды с правами пользователя и могут менять доступные им файлы.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
zx, CLI и библиотека для JavaScript, запускает команды оболочки из сценария. Автор сценария ожидает результаты команд, сохраняет их в переменные и выполняет независимые действия параллельно. Обертка над дочерними процессами экранирует подставляемые аргументы. CLI выполняет такой сценарий как отдельный файл, поэтому агент может подготовить автоматизацию в знакомом языке и проверить ее перед запуском. Пакет работает с несколькими JavaScript-средами и поддерживает как ESM, так и CommonJS.
Для кого. Разработчикам JavaScript, которые собирают многошаговые служебные сценарии с внешними командами.
Подходит, если
- Сценарий разросся до условий и нескольких асинхронных операций.
- Имя ветки или путь с пробелами требуется передать внешней команде как аргумент.
- Несколько независимых проверок можно выполнить параллельно и собрать их результаты.
- Команда хочет хранить служебную автоматизацию рядом с JavaScript-проектом.
Не подходит, если
- На целевой машине нельзя установить поддерживаемую JavaScript-среду.
- Достаточно одной команды без переменных, ветвления и обработки результатов.
- Запускаемый сценарий нельзя проверить, но ему планируют дать доступ к рабочим данным.
Пример запроса к агенту
Подготовь сценарий zx, который запускает две независимые проверки проекта и собирает их результаты. Сначала покажи файл без выполнения.Ограничения
Для запуска нужны поддерживаемая JavaScript-среда и оболочка Bash либо PowerShell; внешние команды устанавливают отдельно. Экранирование аргументов сохраняет их границы, но сценарий по-прежнему работает с файлами и правами пользователя без изоляции. При переносе на другую ОС придется учесть доступные программы и синтаксис оболочки. Репозиторий размещен у Google, однако zx не имеет статуса официально поддерживаемого продукта компании.
Как отключить. Уберите zx из зависимостей проекта или удалите его установленным менеджером пакетов. Остановите запущенные сценарии отдельно.
Частые вопросы
Можно ли использовать async/await?
Да. `await` ожидает завершения команды, а `Promise.all` объединяет независимые действия. Запускайте параллельно только команды, которые не мешают друг другу при работе с общими файлами.
Зачем экранировать аргументы?
Имя ветки или путь с пробелами должны попасть во внешнюю программу одним аргументом. Обертка сохраняет границы подставляемого значения; права и последствия команды остаются прежними.
Работает ли zx в Windows?
Да. Windows поддерживается. Выберите Bash или PowerShell и используйте команды, установленные в этой системе.
Обязателен ли Node.js?
Нет. Помимо Node.js перечислены Bun, Deno и GraalVM Node.js. Сверьте поддерживаемую версию своего окружения с документацией.
Можно ли использовать TypeScript?
Да. В [руководстве TypeScript](https://google.github.io/zx/typescript) выберите вкладку своей среды запуска. Там приведены команды для подготовки и выполнения файла.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыOneScript — CLI для автоматизации на языке 1С: сценарии работают вне платформы, а пакеты подключаются через opm.
Оркестратор для Claude Code, Codex и Gemini CLI: сценарии на YAML повторяются, пока проходят ваши проверки
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub
CLI-лаунчер для агентов: ищет команду среди навыков, запускает ее и возвращает ответ в JSON с понятными кодами выхода.
Скиллы и хуки для сборки рабочих сценариев n8n через MCP-сервер n8n-mcp: выражения, узлы, валидация, ИИ-агенты, self-hosting
MCP-сервер WelsonJS: агент выполняет скрипты JScript на Windows и управляет окнами, Office и COM-объектами.
Коротко о README
В примерах показаны чтение вывода Git и передача переменной другой программе. Вариант [zx@lite](https://google.github.io/zx/lite) содержит основные функции библиотеки без CLI, встроенной документации и man-страниц.