Команды
CLI
Справочник команд dev-workflow для терминала
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 |
tokens analyze|compare|tail [<runId>] [--json] [--all] [--lines N] | Разбор token-трассы run'а: analyze — totals/byStep/bySource/byVaultFile/byEngramType + warnings (без runId — самый свежий по mtime; --all — пул по всем runs); compare <runA> <runB> — per-step Δ с флагом роста >10%; tail [--lines N] — последние N записей (default 20). С --json — структурированный вывод |
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)Веб-дашборд
dev-workflow web [--port N] [--open] # запуск дашборда на http://127.0.0.1:3737Дашборд жёстко привязан к 127.0.0.1 — флага --host нет по дизайну. При занятом порте — fallback на +1..+4 (до 5 попыток). --open открывает браузер (по умолчанию в TTY), --no-open отключает. Ctrl+C — graceful shutdown.
При запуске dev-workflow web регистрирует текущую директорию в реестре проектов (~/.config/dev-workflow/projects.json) и делает её активной, если активного проекта ещё нет — дашборд открывается сразу на этом проекте.