CLI Reference

Все команды запускаются как dev-workflow <command>.

Основные команды

Команда	Описание
`init [--force] [--detect]`	Инициализация vault, хуков, CLAUDE.md, .mcp.json, permissions
`update`	Обновить commands/agents из пакета (vault не трогает)
`spec-template`	Печать встроенного шаблона SPEC.md (Mirror Skeleton)
`settings-template`	Печать встроенного `.claude/settings.json` с абсолютными путями
`communication-template`	Печать встроенного `templates/project/communication-yaml.example` (4 default profiles: onboarding/senior_fast/code_review/bilingual). Bootstrap: `dev-workflow communication-template > .dev-vault/communication.yaml`
`engram-trace <runId> [--raw]`	Сводка трассы engram socket для указанного workflow run (читает JSONL из `ENGRAM_TRACE_FILE`, авто-устанавливается `WorkflowEngine.start()` в `<vault>/workflow-state/runs/<runId>.engram-trace.jsonl`)
`engram-stats [--runs N] [--json]`	Aggregated dashboard последних N runs (default 10): byMethod / byMemoryType / byStep / recentRuns + live engram daemon status. С `--json` — структурированный вывод для tooling
`workflow show <name> [--bodies]`	Инспектировать структуру workflow (опц. inline тела step-файлов)
`workflow graph <name> [--ascii]`	Отрисовать DAG (Mermaid по умолч., ASCII с --ascii)
`workflow effective <name>`	Показать разрешённые step-файлы и subagent'ы
`vault diff [SPEC.md]`	Сравнить SPEC.md с секциями vault (exit 0=match, 1=drift)
`templates-root`	Печать абсолютного пути к встроенным `templates/`
`status [--json]`	Состояние vault, задач, workflow. С `--json` — структурированный вывод для tooling/CI
`doctor [--fix]`	Диагностика: vault, хуки, .mcp.json, permissions, пути
`help`	Справка

Snapshots

Команда	Описание
`snapshot create [name]`	Создать point-in-time snapshot vault'а. Default name: `snap-<ISO>`. Excludes `snapshots/`, `.edit-log.json`, `.profile-state`, `*.engram-trace.jsonl` (regenerable)
`snapshot list`	Таблица существующих snapshots (newest first): name / created / branch / files / size
`snapshot show <name>`	JSON manifest snapshot'а (name, createdAt, projectName, branch, fileCount, totalBytes, excludedPatterns)
`snapshot rollback <name>`	Восстановить vault. Auto-создаёт `pre-rollback-<ISO>` snapshot ДО восстановления — rollback reversible через повторный `snapshot rollback pre-rollback-...`
`snapshot delete <name> [--force]`	Удалить snapshot. Без `--force` показывает что будет удалено и просит подтверждение

Workflows

Команда	Описание
`run <workflow> "задача" [--dry-run [--json]] [--task <id>]`	Запуск workflow. С `--dry-run` — превью pipeline (шаги, subagent-типы, gates, inputs, outputBlock, maxAttempts) без запуска агентов. С `--dry-run --json` — структурированный вывод для tooling
`resume [--run <id>]`	Продолжить паузу
`validate <file.yaml>`	Валидация кастомного workflow

Workflow: dev, hotfix, review, test.

Задачи

Команда	Описание
`task create "title" ["description"]`	Создать задачу
`task list [--status <status>]`	Список задач
`task show <id>`	Детали задачи
`task start <id>`	Старт (привязка к ветке)
`task done <id>`	Завершить
`task block <id>`	Заблокировать

Агенты

Команда	Описание
`agent list`	Список агентов
`agent show <name>`	Детали агента
`agent run <name> "задача"`	Генерация промпта

Поиск и конфигурация

Команда	Описание
`search "запрос"`	Поиск по vault
`config show`	Показать настройки
`config get <path>`	Получить значение
`config set <path> <value>`	Установить значение
`export [file.json]`	Экспорт vault
`import <file.json>`	Импорт vault

MCP-сервер

dev-workflow serve    # запуск MCP-сервера (stdin/stdout JSON-RPC)

CLI

On this page