Справочник CLI-команд: полный список команд и описание параметров

В этом разделе представлен полный справочник по CLI-инструменту Agent App Factory.

Обзор команд

Команда	Функция	Сценарий использования
`factory init`	Инициализация проекта Factory	Начало нового проекта
`factory run [stage]`	Запуск конвейера	Выполнение или продолжение конвейера
`factory continue`	Продолжение в новой сессии	Экономия токенов, выполнение по сессиям
`factory status`	Просмотр статуса проекта	Отслеживание текущего прогресса
`factory list`	Список всех проектов	Управление несколькими проектами
`factory reset`	Сброс состояния проекта	Перезапуск конвейера

factory init

Инициализирует текущую директорию как проект Factory.

Синтаксис

bash

factory init [options]

Параметры

Параметр	Сокращение	Тип	Обязательный	Описание
`--name`	`-n`	string	Нет	Название проекта
`--description`	`-d`	string	Нет	Описание проекта

Описание функциональности

После выполнения команды factory init происходит следующее:

Проверка безопасности директории (допускаются только .git, .gitignore, README.md и другие конфигурационные файлы)
Создание директории .factory/
Копирование следующих файлов в .factory/:
- agents/ — файлы определения агентов
- skills/ — модули навыков
- policies/ — документы политик
- templates/ — шаблоны конфигурации
- pipeline.yaml — определение конвейера
Генерация config.yaml и state.json
Генерация .claude/settings.local.json (конфигурация разрешений Claude Code)
Попытка установки необходимых плагинов:
- superpowers (требуется для этапа Bootstrap)
- ui-ux-pro-max-skill (требуется для этапа UI)
Автоматический запуск AI-ассистента (Claude Code или OpenCode)

Примеры

Инициализация проекта с указанием названия и описания:

bash

factory init --name "Todo App" --description "Простое приложение для списка задач"

Инициализация проекта в текущей директории:

bash

factory init

Важные замечания

Директория должна быть пустой или содержать только конфигурационные файлы (.git, .gitignore, README.md)
Если директория .factory/ уже существует, будет предложено использовать factory reset для сброса

factory run

Запускает конвейер с текущего или указанного этапа.

Синтаксис

bash

factory run [stage] [options]

Параметры

Параметр	Сокращение	Тип	Обязательный	Описание
`stage`	-	string	Нет	Название этапа конвейера (bootstrap/prd/ui/tech/code/validation/preview)

Опции

Опция	Сокращение	Тип	Описание
`--force`	`-f`	flag	Пропустить запрос подтверждения

Описание функциональности

После выполнения команды factory run происходит следующее:

Проверка, является ли директория проектом Factory
Чтение config.yaml и state.json
Отображение текущего состояния конвейера
Определение целевого этапа (указанного в параметре или текущего)
Определение типа AI-ассистента (Claude Code / Cursor / OpenCode)
Генерация инструкций для соответствующего ассистента
Отображение списка доступных этапов и прогресса

Примеры

Запуск конвейера с этапа bootstrap:

bash

factory run bootstrap

Продолжение выполнения с текущего этапа:

bash

factory run

Запуск без подтверждения:

bash

factory run bootstrap --force

Пример вывода

Agent Factory - Pipeline Runner

Pipeline Status:
────────────────────────────────────────
Project: Todo App
Status: Running
Current Stage: bootstrap
Completed: 

🤖 Claude Code Instructions:
──────────────────────────
This is an Agent Factory project. To execute the pipeline:

1. Read pipeline definition:
   Read(/path/to/.factory/pipeline.yaml)

2. Read orchestrator agent:
   Read(/path/to/.factory/agents/orchestrator.checkpoint.md)

3. Read project config:
   Read(/path/to/.factory/config.yaml)

Then execute the pipeline starting from: bootstrap

────────────────────────────────────────
Available stages:
  ○ bootstrap
  ○ prd
  ○ ui
  ○ tech
  ○ code
  ○ validation
  ○ preview

────────────────────────────────────────
Ready! Follow instructions above to continue.

factory continue

Продолжает выполнение конвейера в новой сессии для экономии токенов.

Синтаксис

bash

factory continue

Описание функциональности

После выполнения команды factory continue происходит следующее:

Проверка, является ли директория проектом Factory
Чтение state.json для получения текущего состояния
Повторная генерация конфигурации разрешений Claude Code
Запуск нового окна Claude Code
Продолжение выполнения с текущего этапа

Сценарии использования

После завершения каждого этапа — для предотвращения накопления токенов
Каждый этап получает чистый контекст
Поддержка восстановления после прерывания

Примеры

Продолжение выполнения конвейера:

bash

factory continue

Важные замечания

Требуется установленный Claude Code
Автоматически запускается новое окно Claude Code

factory status

Отображает подробный статус текущего проекта Factory.

Синтаксис

bash

factory status

Описание функциональности

После выполнения команды factory status отображается:

Название проекта, описание, путь, время создания
Состояние конвейера (idle/running/waiting_for_confirmation/paused/failed/completed)
Текущий этап
Список завершённых этапов
Прогресс по каждому этапу
Состояние входного файла (input/idea.md)
Состояние директории артефактов (artifacts/)
Количество и размер файлов артефактов

Примеры

bash

factory status

Пример вывода

Agent Factory - Project Status

Project:
  Name: Todo App
  Description: Простое приложение для списка задач
  Path: /Users/user/Projects/todo-app
  Created: 2026-01-29T10:00:00.000Z

Pipeline:
  Status: Running
  Current Stage: prd
  Completed: bootstrap

Progress:
  ✓ bootstrap
  → prd
  ○ ui
  ○ tech
  ○ code
  ○ validation
  ○ preview

Input:
  File: input/idea.md
  Lines: 25
  Preview:
    # Todo App

    Простое приложение для списка задач...

Artifacts:
  ✓ prd (3 files, 12.5 KB)

────────────────────────────────────────
Commands:
  factory run     - Run pipeline
  factory run <stage> - Run from stage
  factory reset  - Reset pipeline state

factory list

Выводит список всех проектов Factory.

Синтаксис

bash

factory list

Описание функциональности

После выполнения команды factory list происходит следующее:

Поиск в типичных директориях проектов (~/Projects, ~/Desktop, ~/Documents, ~)
Поиск в текущей директории и родительских директориях (до 3 уровней вверх)
Вывод списка всех проектов, содержащих директорию .factory/
Отображение статуса проектов (сортировка: выполняющиеся, ожидающие, с ошибками, завершённые)

Примеры

bash

factory list

Пример вывода

Agent Factory - Projects

Found 2 project(s):

◉ Todo App
  Простое приложение для списка задач
  Path: /Users/user/Projects/todo-app
  Stage: prd

○ Blog System
  Система блога
  Path: /Users/user/Projects/blog
  Completed: bootstrap

────────────────────────────────────────
Work on a project: cd <path> && factory run

factory reset

Сбрасывает состояние конвейера текущего проекта, сохраняя артефакты.

Синтаксис

bash

factory reset [options]

Опции

Опция	Сокращение	Тип	Описание
`--force`	`-f`	flag	Пропустить подтверждение

Описание функциональности

После выполнения команды factory reset происходит следующее:

Проверка, является ли директория проектом Factory
Отображение текущего состояния
Запрос подтверждения сброса (если не указан --force)
Сброс state.json в начальное состояние
Обновление раздела pipeline в config.yaml
Сохранение всех артефактов в artifacts/

Сценарии использования

Перезапуск с этапа bootstrap
Устранение ошибок состояния
Переконфигурация конвейера

Примеры

Сброс состояния проекта:

bash

factory reset

Сброс без подтверждения:

bash

factory reset --force

Важные замечания

Сбрасывается только состояние конвейера, артефакты не удаляются
Для полного удаления проекта необходимо вручную удалить директории .factory/ и artifacts/

Приложение: справочник по исходному коду

Нажмите, чтобы развернуть расположение исходного кода

Дата обновления: 2026-01-29

Команда	Путь к файлу	Строки
Точка входа CLI	`cli/bin/factory.js`	17-122
Команда init	`cli/commands/init.js`	1-457
Команда run	`cli/commands/run.js`	1-335
Команда continue	`cli/commands/continue.js`	1-144
Команда status	`cli/commands/status.js`	1-203
Команда list	`cli/commands/list.js`	1-160
Команда reset	`cli/commands/reset.js`	1-100

Ключевые функции:

getFactoryRoot() — получение корневой директории Factory (factory.js:22-52)
isFactoryProject() — проверка, является ли директория проектом Factory (init.js:22-26)
generateConfig() — генерация конфигурации проекта (init.js:58-76)
launchClaudeCode() — запуск Claude Code (init.js:119-147)
launchOpenCode() — запуск OpenCode (init.js:152-215)
detectAIAssistant() — определение типа AI-ассистента (run.js:105-124)
updateState() — обновление состояния конвейера (run.js:94-100)

Зависимости:

commander — парсинг аргументов CLI
chalk — цветной вывод в терминале
ora — анимация загрузки
inquirer — интерактивные подсказки
yaml — парсинг YAML-файлов
fs-extra — операции с файловой системой

Справочник CLI-команд: полный список команд и описание параметров ​

Обзор команд ​

factory init ​

Синтаксис ​

Параметры ​

Описание функциональности ​

Примеры ​

Важные замечания ​

factory run ​

Синтаксис ​

Параметры ​

Опции ​

Описание функциональности ​

Примеры ​

Пример вывода ​

factory continue ​

Синтаксис ​

Описание функциональности ​

Сценарии использования ​

Примеры ​

Важные замечания ​

factory status ​

Синтаксис ​

Описание функциональности ​

Примеры ​

Пример вывода ​

factory list ​

Синтаксис ​

Описание функциональности ​

Примеры ​

Пример вывода ​

factory reset ​

Синтаксис ​

Опции ​

Описание функциональности ​

Сценарии использования ​

Примеры ​

Важные замечания ​

Приложение: справочник по исходному коду ​

Справочник CLI-команд: полный список команд и описание параметров

Обзор команд

factory init

Синтаксис

Параметры

Описание функциональности

Примеры

Важные замечания

factory run

Синтаксис

Параметры

Опции

Описание функциональности

Примеры

Пример вывода

factory continue

Синтаксис

Описание функциональности

Сценарии использования

Примеры

Важные замечания

factory status

Синтаксис

Описание функциональности

Примеры

Пример вывода

factory list

Синтаксис

Описание функциональности

Примеры

Пример вывода

factory reset

Синтаксис

Опции

Описание функциональности

Сценарии использования

Примеры

Важные замечания

Приложение: справочник по исходному коду