Справочник CLI-команд

Полный, организованный список подкоманд mockarty-cli. CLI группирует
команды на четыре категории плюс небольшой кластер auth/state.
Пользуйтесь страницей, когда примерно знаете, что нужно, но не помните
точную команду. Для интерактивной справки — --help к любой команде.

Категории видны в mockarty-cli --help:

• Cat 1 — Utilities. Чистые локальные хелперы (бесплатно в любом режиме).
• Cat 2 — Install. Установка и lifecycle Mockarty.
• Cat 3 — Test runners. Гейтнутые лицензией основные раннеры.
• Cat 4 — TUI. Интерактивный терминальный интерфейс.
• Auth & state. Логин, конфиг, namespace, токены.

Большинство команд принимают глобальные флаги:

Послойная безопасность LLM

mockarty-cli llm-security управляет политикой защиты от prompt injection для
активного пространства. Оно выбирается по порядку: --namespace, переменная
окружения, сохранённый контекст входа.

Добавьте --installation к get, set или events для системного
администратора. Примеры политик и правила доступа — в разделе
LLM Guardrails.

mockarty-cli connections — неизменяемые внешние подключения

Команды используют настроенные сервер, токен и конкретное пространство имён. Файл descriptor содержит точные ссылки на секреты, но не исходные учётные данные. Подробнее: Connection Authority.

Cat 1 — Utilities

Бесплатно в любом режиме. Сервер и токен не нужны.

mockarty-cli util — хелперы

mockarty-cli tunnel — SSH-подобный туннель

Открыть локальный порт, проксируемый через соединение Mockarty (удобно,
чтобы прокинуть локальный мок удалённому потребителю).

mockarty-cli matcher — проверка HTTP-сопоставления

Используйте mockarty-cli matcher status с токеном администратора, когда
нужно проверить, как сервер выбирает мок для входящего HTTP-запроса.
Команда показывает режим каждого пространства имён (off, shadow или
on), текущую ревизию и различия, найденные при сравнении поведения.
Изучите различия перед включением нового сопоставления. Если команда
сообщает, что сопоставление не инициализировано, попросите администратора
проверить настройку сервера. Команда только читает состояние и не меняет режим.

mockarty-cli sniff — HAR-снифер

Перехватывает HTTP через локальный прокси-порт и пишет HAR.

mockarty-cli init — каркас проекта

Генерирует скелет проекта в текущей директории: декларативный манифест
пайплайна (mockarty.yaml), ignore-файл и пример коллекции. Флейворы:
generic (по умолчанию), python (pytest-плагин), go (тест на Go SDK).

mockarty-cli extension — браузерное расширение записи

mockarty-cli serve / serve-api / serve-grpc — встроенный мини-сервер

Standalone мок-сервер (HTTP, REST, gRPC) без admin-узла. Примеры —
Quick start.

mockarty-cli mcp — stdio MCP-сервер для AI-агентов

Запускает CLI как Model Context Protocol
сервер поверх stdio, чтобы AI-агенты (Claude Code, Cursor, …) могли управлять
Mockarty. Добавьте в конфиг MCP-клиента:

{
  "mcpServers": {
    "mockarty": {
      "command": "mockarty-cli",
      "args": ["mcp"]
    }
  }
}

Бесплатные локальные инструменты доступны всегда — сервер и токен не нужны:

Когда указан сервер (--server/--token, env-переменные или сохранённый
логин-контекст), все MCP-инструменты этого сервера дополнительно
проксируются под их каноническими именами — на них действует ваша лицензия.
Если сервер недоступен или токен неверен, CLI пишет одно предупреждение в
stderr и продолжает только с локальными инструментами. Флаг --local-only
отключает проксирование.

mockarty-cli recorder local — локальный HAR-recorder

mockarty-cli recorder local --listen 127.0.0.1:8889 --output session.har

Пишет каждый запрос, проходящий через bind-порт, в HAR-архив.
Полностью in-process. Серверная сторона — Recorder.

mockarty-cli generate — codegen скриптов / клиентов

mockarty-cli generate <subcommand>

Скаффолды для мок-проектов, perf-скриптов, контрактных файлов. Полный
список — --help у подкоманды.

generate spec выполняет все остальные генераторы В ОБРАТНУЮ СТОРОНУ: вход —
всегда моки, которые уже есть в пространстве имён, поэтому файла он не берёт.
Документ идёт в stdout, а предупреждения (моки, которые спецификация не может
выразить) — в stderr, поэтому mockarty-cli generate spec --format openapi > openapi.json записывает файл, который потребитель сможет разобрать.
--format asyncapi — для моков Kafka/RabbitMQ/NATS/socket/SMTP, --tags и
--folder сужают набор, --out пишет в файл.

Cat 2 — Install

Управление локальной установкой Mockarty.

Cat 3 — Test runners

Полная поверхность фич. Гейтнутая лицензией в Community / Licensed.

Авторинг моков

mock serve --anon-limit N перекрывает дефолтный 5-stub cap в
anonymous-режиме. Для тестов, которым нужно больше моков без
подключения к серверу.

Функциональный раннер

Частые флаги:

• --reporter cli|json:file|junit:file|allure:dir|html:dir (повторяемый).
• --namespace NS — перекрыть активный namespace.

Нагрузочный раннер

Локальный CLI без сервера: до 500 VU и 2 минут (см. доступность функций).

Fuzzing

Подкоманды повторяют fuzz-API сервера; см. mockarty-cli fuzz --help.

Postman / Newman compat

Recorder (серверный)

Контрактное тестирование

Chaos engineering (pre-GA — Chaos pre-GA)

«opt-in» = передайте --i-know-this-is-preview или поставьте
MOCKARTY_CHAOS_PREVIEW=1. Read-only команды работают без opt-in.

Коллекции в git

Тестовые флоу (Go DSL)

Тест-планы и запуски

Управление тест-кейсами (TCM)

Агент безопасности

Хранилище секретов

AI-промпты

UI- и мобильные тесты

Корзина

Миграция из других инструментов

--report <file> записывает предполёт миграции: какие кейсы назначение не сможет хранить как есть (нет заголовка, нет шагов, приоритет вне его словаря, либо один и тот же external id дважды за прогон), поля с формой учётных данных ВНУТРИ переносимых данных (с именем кейса и поля, но НИКОГДА со значением) и точный список external id, которые прогон создал — то, что удалять, если миграция была ошибкой. Повторный прогон идемпотентен по этим id, поэтому частичную миграцию исправляют повтором, а не уборкой. Файл пишется с правами 0600.
| migrate from-allure | Переписать импорты сторонних Allure SDK на эквиваленты Mockarty. |
| allure … | Drop-in замена allurectl — приём allure-results/ в TCM. |
| testit … | Загрузка JUnit XML (results upload --results/-r) или преобразованного JSON (--file), управление прогонами и конфигурациями Mockarty. Существующим framework-адаптерам нужна замена или преобразование. |

Аудит и поиск

Отчёты тестов

CI-оркестрация

Cat 4 — TUI

Полный тур экранов — TUI user guide.

Auth & state

Config

Namespace

Token

Делегированные учётные данные

Токены, у которых набор namespace, набор действий и срок действия зафиксированы
выпустившим и не могут быть расширены получателем. Используйте их для совместной
работы с подрядчиком, CI-задачей или MCP-клиентом вместо передачи API-токена,
namespace которого — значение по умолчанию, изменяемое владельцем. См.
Делегированные учётные данные.

create требует --namespaces и --expires. --namespaces стоит во множественном
числе намеренно: это НАБОР, к которому привязаны учётные данные, а не глобальный
--namespace, в котором работает сессия CLI.

# Один namespace, только чтение, 30 дней.
mockarty-cli delegated-credential create --name ci-reader \
  --namespaces staging --actions read --expires 30d

# Получатель использует их так же, как API-токен.
MOCKARTY_API_KEY=mkd_... mockarty-cli mock list

Store

Backup

Cluster (admin / support)

Проверка знаний агентов

Для публикации --expires-at, --supersedes и повторяемый --contradicts
задают срок и связи. Передавайте идентификаторы только после проверки связанных
записей в Миссии → Знания. Один ключ идемпотентности повторно используется
только при ретрае того же решения.

Коды выхода

Команда возвращает 0 только тогда, когда работа действительно выполнена.
Команда, напечатавшая ошибку, никогда не выходит с 0 — шаг CI может
полагаться на один лишь код.

Три кода означают одно и то же во всей CLI, поэтому пайплайн может
ветвиться по ним, не зная, какая именно команда отработала:

В CI важнее всего 2: именно он отделяет «тесты красные» от «шаг пайплайна
настроен неправильно». Опечатка в подкоманде
(mockarty-cli perf runn script.js) и неизвестный флаг дают 2 — они
никогда не выглядят как успешно пройденный шаг.

mock convert --report preflight.json дополнительно записывает то, на что импорт обязан ответить до того, как ему поверят: какие файлы поняты (и как какой формат), что приближено (gaps), какие учётные данные несут ИСХОДНЫЕ артефакты — с именем файла, видом и JSON-путём, но НИКОГДА со значением, — и что означает откат конверсии (этот путь пишет только файлы, поэтому откат — удаление, и отчёт называет каталог). Файл пишется с правами 0600: это карта того, где лежат учётные данные.
| results upload | все результаты из пачки сохранены на сервере | 1 — в каталоге не оказалось результатов либо сервер сохранил только часть пачки (в сообщении сколько из скольких); 2 — не настроен сервер либо сервер не принимает выгрузку результатов (ничего не сохранено). Если нужна только локальная сводка — --dry-run. |
| allure upload | все *-result.json и упомянутые вложения доехали до Mockarty | 1 — не выгрузился результат или вложение, выгрузка прервана либо в каталоге не оказалось результатов |
| allure export | записан хотя бы один *-result.json и сопутствующие файлы | 1 — в прогоне нет результатов, --filter-by-* отсёк все, не записался сопутствующий файл или (с --plan-id) не выгрузился какой-то прогон сьюта |
| allure launch create | лаунч создан и напечатан LAUNCH_ID= | 2 — сервер ответил без идентификатора лаунча, привязать к нему уже ничего нельзя |
| allure launch close | лаунч закрыт, записанный итог зелёный | 1 — лаунч закрыт как failed либо в него вообще не приехало результатов. --abort фиксирует прерванный пайплайн и сохраняет свой вердикт. |
| testit results upload | все разобранные результаты доехали до Mockarty | 1 — пустой или некорректный ввод либо какой-то результат не доехал (в сообщении сколько из скольких) |
| testit import | экспорт разобран (кейсы созданы или обновлены) | 1 — упал рабочий элемент либо не импортировано вообще ничего; 2 — не прочитана сводка сервера, подтвердить импорт нельзя |
| collection export-git | дерево записано в --dir | 1 — сервер вернул пустой архив (ни одного файла не записано) |
| collection import-git | импортированы все запросы из дерева | 1 — какой-то запрос не импортирован (HTTP 207, частичный импорт) либо не импортировано ни одного; 2 — не прочитана сводка сервера |
| recorder import-ui-actions | все разобранные действия приняты сессией | 1 — в файле не распознано ни одного UI-действия (не тот диалект) либо сессия приняла меньше действий, чем отправлено. --dry-run падает на том же пустом разборе. |
| mobile run | прогон отправлен на устройство (а с --wait — прошёл) | 1 — прогон упал либо на какое-то устройство из --all-devices / --device-selector не удалось отправить задачу; 2 — сервер принял прогон, но не вернул id задачи, отследить его нельзя |
| mobile apps upload | сборка загружена и её id напечатан | 2 — сервер не вернул id артефакта, сослаться на сборку нечем |
| chaos cluster test | подключились И проба возможностей отработала | 1 — проба возможностей не отработала; кластер не подтверждён как пригодный для экспериментов |
| chaos cluster info | прочитаны все разделы отчёта | 1 — какой-то раздел (namespaces, узлы, возможности) прочитать не удалось |
| chaos operator install | созданы RBAC и деплоймент | 1 — не создалась предпосылка (ServiceAccount, ClusterRole, binding); оператор НЕ развёрнут |
| chaos operator status | оператор развёрнут и готов | 1 — не установлен либо готово меньше реплик, чем нужно |
| chaos operator uninstall | удалены все объекты | 1 — объект остался в кластере (забытый ClusterRole сохраняет права на весь кластер) |
| health | сервер ответил и сообщает, что здоров | 1 — сервер недоступен или сообщает нездоровый статус |
| verify | все запрошенные проверки прошли | 1 — проверка не прошла; 2 — не настроен сервер |
| testplan run --wait | прогон завершился без упавших элементов | 1 провал · 2 отменён · 3 истекло ожидание |

Пять пунктов стоит выделить — на них проще всего обжечься в пайплайне:

• Прогон, не выполнивший ничего, — это провал, а не успех. --folder
  сопоставляет префикс имени запроса, а не путь папки, поэтому фильтр,
  не совпавший ни с чем, — частый способ ничего не протестировать. То же
  касается манифеста test run, где опечатка в dependsOn пропускает все
  шаги.
• Нагрузочный тест, ничего не измеривший, — провал. Если в сводке
  Requests: 0, смотрите строки ERROR: над ней: итерация, падающая с
  исключением (например, забытый import http from "k6/http"), не оставляет
  что измерять.
• Отчёт, который вы запросили и не получили, — провал. Если
  --reporter junit:report.xml не смог записать файл, команда падает даже
  когда все тесты прошли, — иначе CI собирает несуществующий артефакт.
• Выгрузка или экспорт, ничего не доставившие, — провал. allure upload,
  testit results upload и results upload падают на пустом каталоге
  результатов и падают снова, если сервер сохранил лишь часть отправленного:
  история прогонов с потерянными строками хуже, чем её отсутствие.
  allure export падает, когда не записал ни одного *-result.json, —
  из пустого каталога allure generate отчёт не соберёт.
• -o json никогда не меняет вердикт. Машиночитаемый вывод
  контрактной проверки несёт тот же код возврата, что и человекочитаемый.

Хранение автономных миссий

mockarty-cli autonomy settings get читает текущую политику пространства. autonomy settings set задаёт стену автономного прогона через --run-window-minutes либо очищает это переопределение через --inherit-run-window. Та же команда меняет --event-days / --payload-days и очищает их через --inherit-event / --inherit-payload. Передайте --request-id <стабильный-id> и повторите то же значение после таймаута или потери ответа; новый запуск без флага намеренно создаёт новую квитанцию изменения.

Окружения delivery policy

Для этих команд нужны administrator credential и настроенное authority-подключение.
JSON запроса содержит id (только при создании), projectId, class, profile,
auditId и evidenceId; seal одобрения в него передавать нельзя.

mockarty-cli delivery-policy environments list --status active --limit 50
mockarty-cli delivery-policy environments get staging
mockarty-cli delivery-policy environments create --file environment.json --idempotency-key staging-v1
mockarty-cli delivery-policy environments advance staging --file environment-v2.json --etag '"dp-env:..."' --idempotency-key staging-v2
mockarty-cli delivery-policy environments revoke staging --etag '"dp-env:..."'
mockarty-cli delivery-policy grants get grant-123

Completion-скрипты

mockarty-cli completion bash > /etc/bash_completion.d/mockarty-cli
mockarty-cli completion zsh  > "${fpath[1]}/_mockarty-cli"
mockarty-cli completion fish > ~/.config/fish/completions/mockarty-cli.fish
mockarty-cli completion powershell | Out-String | Invoke-Expression

Куда дальше

• CLI user guide — описательное руководство.
• TUI user guide — интерактивная поверхность.
• OAuth login — детали аутентификации.
• Feature gating — что разблокирует каждый режим.
• Chaos pre-GA — opt-in.
• Allure-аннотации — богатые отчёты.