Справочник по CLI

CLI OpenSpec (openspec) предоставляет терминальные команды для настройки проекта, валидации, проверки статуса и управления. Эти команды дополняют слеш-команды ИИ (такие как /opsx:propose), описанные в разделе Команды.

Сводка

Категория	Команды	Назначение
Настройка	`init`, `update`	Инициализация и обновление OpenSpec в вашем проекте
Рабочие пространства (бета)	`workspace setup`, `workspace list`, `workspace ls`, `workspace link`, `workspace relink`, `workspace doctor`, `workspace open`	Настройка планирования в связанных репозиториях или папках
Просмотр	`list`, `view`, `show`	Просмотр изменений и спецификаций
Валидация	`validate`	Проверка изменений и спецификаций на наличие проблем
Жизненный цикл	`archive`	Завершение выполненных изменений
Рабочий процесс	`status`, `instructions`, `templates`, `schemas`	Поддержка рабочего процесса на основе артефактов
Схемы	`schema init`, `schema fork`, `schema validate`, `schema which`	Создание и управление пользовательскими рабочими процессами
Конфигурация	`config`	Просмотр и изменение настроек
Утилиты	`feedback`, `completion`	Обратная связь и интеграция с оболочкой

Команды для людей и агентов

Большинство CLI-команд предназначены для интерактивного использования в терминале. Некоторые команды также поддерживают использование агентами/скриптами через JSON-вывод.

Команды только для интерактивного использования

Эти команды являются интерактивными и предназначены для работы в терминале:

Команда	Назначение
`openspec init`	Инициализация проекта (интерактивные запросы)
`openspec view`	Интерактивная панель управления
`openspec config edit`	Открытие конфигурации в редакторе
`openspec feedback`	Отправка обратной связи через GitHub
`openspec completion install`	Установка автодополнений для оболочки

Команды, совместимые с агентами

Эти команды поддерживают вывод в формате --json для программного использования AI-агентами и скриптами:

Команда	Интерактивное использование	Использование агентом
`openspec list`	Просмотр изменений/спецификаций	`--json` для структурированных данных
`openspec show <item>`	Чтение содержимого	`--json` для парсинга
`openspec validate`	Проверка на наличие проблем	`--all --json` для массовой валидации
`openspec status`	Просмотр прогресса артефактов	`--json` для структурированного статуса
`openspec instructions`	Получение следующих шагов	`--json` для инструкций агенту
`openspec templates`	Поиск путей к шаблонам	`--json` для разрешения путей
`openspec schemas`	Список доступных схем	`--json` для обнаружения схем
`openspec workspace setup --no-interactive`	Создание рабочей области с явными входными данными	`--json` для структурированного вывода настройки
`openspec workspace list`	Просмотр известных рабочих областей	`--json` для типизированных объектов рабочих областей
`openspec workspace link`	Привязка репозитория или папки	`--json` для структурированного вывода привязки
`openspec workspace relink`	Исправление привязанного пути	`--json` для структурированного вывода привязки
`openspec workspace doctor`	Проверка одной рабочей области	`--json` для структурированного вывода статуса

Глобальные параметры

Эти параметры работают со всеми командами:

Параметр	Описание
`--version`, `-V`	Показать номер версии
`--no-color`	Отключить цветной вывод
`--help`, `-h`	Показать справку по команде

Команды настройки

`openspec init`

Инициализация OpenSpec в вашем проекте. Создаёт структуру папок и настраивает интеграции с AI-инструментами.

Поведение по умолчанию использует глобальные настройки конфигурации: профиль core, режим доставки both, рабочие процессы propose, explore, apply, sync, archive.

openspec init [path] [options]

Аргументы:

Аргумент	Обязательный	Описание
`path`	Нет	Целевая директория (по умолчанию: текущая директория)

Параметры:

Параметр	Описание
`--tools <list>`	Настройка AI-инструментов в неинтерактивном режиме. Используйте `all`, `none` или список через запятую
`--force`	Автоматическая очистка устаревших файлов без запроса подтверждения
`--profile <profile>`	Переопределение глобального профиля для данного запуска init (`core` или `custom`)

--profile custom использует рабочие процессы, выбранные в данный момент в глобальной конфигурации (openspec config profile).

Поддерживаемые идентификаторы инструментов (--tools): amazon-q, antigravity, auggie, bob, claude, cline, codex, forgecode, codebuddy, continue, costrict, crush, cursor, factory, gemini, github-copilot, iflow, junie, kilocode, kimi, kiro, opencode, pi, qoder, lingma, qwen, roocode, trae, windsurf

Примеры:

bash

# Интерактивная инициализация
openspec init

# Инициализация в указанной директории
openspec init ./my-project

# Неинтерактивный режим: настройка для Claude и Cursor
openspec init --tools claude,cursor

# Настройка для всех поддерживаемых инструментов
openspec init --tools all

# Переопределение профиля для данного запуска
openspec init --profile core

# Пропуск запросов и автоматическая очистка устаревших файлов
openspec init --force

Что создаётся:

openspec/
├── specs/              # Ваши спецификации (источник истины)
├── changes/            # Предлагаемые изменения
└── config.yaml         # Конфигурация проекта

.claude/skills/         # Навыки Claude Code (если выбран claude)
.cursor/skills/         # Навыки Cursor (если выбран cursor)
.cursor/commands/       # OPSX-команды Cursor (если режим доставки включает команды)
... (конфигурации других инструментов)

`openspec update`

Обновление файлов инструкций OpenSpec после обновления CLI. Повторно генерирует конфигурационные файлы AI-инструментов, используя текущий глобальный профиль, выбранные рабочие процессы и режим доставки.

openspec update [path] [options]

Аргументы:

Аргумент	Обязательный	Описание
`path`	Нет	Целевая директория (по умолчанию: текущая директория)

Параметры:

Параметр	Описание
`--force`	Принудительное обновление, даже если файлы актуальны

Пример:

bash

# Обновление файлов инструкций после обновления npm
npm update @fission-ai/openspec
openspec update

Команды рабочих областей

Команды рабочих областей находятся в активной разработке и ещё не готовы к использованию. Не создавайте внешнюю автоматизацию, интеграции или долгосрочные рабочие процессы на основе этого набора команд; поведение команд, файлы состояния и JSON-вывод могут измениться в любой момент.

Координационные рабочие области — это планировочные пространства для работы, охватывающей несколько репозиториев или папок. Видимость рабочей области не означает обязательства по внесению изменений: привяжите репозитории или папки, которые OpenSpec должен знать, а затем создавайте изменения, когда будете готовы планировать конкретную работу.

`openspec workspace setup`

Создание рабочей области в стандартном расположении OpenSpec и привязка хотя бы одного существующего репозитория или папки.

bash

openspec workspace setup [options]

Параметры:

Параметр	Описание
`--name <name>`	Имя рабочей области. Имена должны быть в формате kebab-case
`--link <path>`	Привязка существующего репозитория или папки с автоматическим определением имени привязки из имени папки
`--link <name>=<path>`	Привязка существующего репозитория или папки с явным указанием имени привязки
`--opener <id>`	Сохранение предпочтительного открывателя при неинтерактивной настройке: `codex`, `claude`, `github-copilot` или `editor`
`--no-interactive`	Отключение запросов; требуются `--name` и хотя бы один `--link`
`--json`	Вывод в формате JSON; требует `--no-interactive`

Примеры:

bash

openspec workspace setup
openspec workspace setup --no-interactive --name platform --link /repos/api --link web=/repos/web
openspec workspace setup --no-interactive --name platform --link /repos/api --opener codex
openspec workspace setup --no-interactive --json --name checkout --link /repos/platform/apps/checkout

Интерактивная настройка запрашивает предпочтительный открыватель и сохраняет его в локальном состоянии рабочей области на машине. Неинтерактивная настройка сохраняет предпочтительный открыватель только при указании --opener; в противном случае workspace open запрашивает выбор позже в интерактивных терминалах, когда доступен поддерживаемый открыватель, или просит скрипты передать --agent <tool> или --editor.

`openspec workspace list`

Вывод списка известных рабочих областей OpenSpec из локального реестра.

bash

openspec workspace list [--json]
openspec workspace ls [--json]

Список показывает расположение каждой рабочей области и привязанные репозитории или папки. Устаревшие записи реестра отображаются, но не изменяются.

`openspec workspace link`

Запись существующего репозитория или папки для одной рабочей области.

bash

openspec workspace link [name] <path> [options]

Параметры:

Параметр	Описание
`--workspace <name>`	Выбор известной рабочей области из локального реестра
`--json`	Вывод в формате JSON
`--no-interactive`	Отключение запросов выбора рабочей области

Примеры:

bash

openspec workspace link /repos/api
openspec workspace link api-service /repos/api
openspec workspace link --workspace platform /repos/platform/apps/checkout

Путь должен уже существовать. Относительные пути разрешаются относительно текущей директории команды перед тем, как OpenSpec сохранит проверенный абсолютный путь в локальном состоянии рабочей области на машине. Привязанные пути могут быть полными репозиториями, пакетами, сервисами, приложениями или папками без локального состояния openspec/ в репозитории.

`openspec workspace relink`

Исправление или изменение локального пути для существующей привязки.

bash

openspec workspace relink <name> <path> [options]

Путь должен уже существовать. Relink обновляет только локальный путь на машине для стабильного имени привязки.

`openspec workspace doctor`

Проверка того, что одна рабочая область может разрешить на текущей машине.

bash

openspec workspace doctor [options]

Doctor показывает расположение рабочей области, путь планирования, привязанные репозитории или папки, отсутствующие пути, пути локальных спецификаций репозитория (при наличии) и предлагаемые исправления. Команда только сообщает о проблемах; она не исправляет их автоматически.

Командам, которым нужна одна рабочая область, используется текущая рабочая область при запуске из папки рабочей области или поддиректории. В остальных случаях передайте --workspace <name>, выберите из списка в интерактивном терминале или полагайтесь на единственную известную рабочую область, если существует ровно одна. В режиме --json или --no-interactive неоднозначный выбор завершается ошибкой со структурированным статусом и предлагает --workspace <name>.

JSON-ответы используют типизированные объекты и массивы status. Основные данные находятся в workspace, workspaces или link; предупреждения и ошибки — в status.

`openspec workspace open`

Открытие рабочего набора рабочей области через сохранённый предпочтительный открыватель, одноразовую переопределение агента или режим редактора VS Code.

bash

openspec workspace open [name] [options]

Параметры:

Параметр	Описание
`--workspace <name>`	Псевдоним для позиционного имени рабочей области
`--agent <tool>`	Одноразовое переопределение агента: `codex`, `claude` или `github-copilot`
`--editor`	Открытие поддерживаемого файла рабочей области VS Code как обычной рабочей области редактора
`--no-interactive`	Отключение запросов выбора рабочей области и открывателя

Примеры:

bash

openspec workspace open
openspec workspace open platform
openspec workspace open platform --agent github-copilot
openspec workspace open --agent codex
openspec workspace open --editor

workspace open использует текущую рабочую область при запуске внутри неё, автоматически выбирает единственную известную рабочую область при запуске из другого места и запрашивает выбор пользователя, когда известно несколько рабочих областей. --agent и --editor не изменяют сохранённый предпочтительный открыватель. Передача обоих переопределений открывателя является ошибкой; выберите либо --agent <tool>, либо --editor.

OpenSpec поддерживает файл <workspace-name>.code-workspace в корне рабочей области для открытия в редакторе VS Code и GitHub Copilot-in-VS-Code. Этот файл является локальным для машины и по умолчанию игнорируется с помощью специальной записи <workspace-name>.code-workspace в .gitignore, поэтому созданные пользователем файлы *.code-workspace остаются доступными для отслеживания.

Поддерживаемая рабочая область VS Code включает корень координации как . плюс валидные привязанные репозитории или папки как дополнительные корни. VS Code отображает эти записи как мультикорневую рабочую область.

Открытие корневой рабочей области поддерживает исследование и планирование через привязанные репозитории или папки. Изменения реализации должны начинаться только после явного запроса пользователя и обычного рабочего процесса реализации OpenSpec.

Команды просмотра

`openspec list`

Вывод списка изменений или спецификаций в вашем проекте.

openspec list [options]

Параметры:

Параметр	Описание
`--specs`	Вывести спецификации вместо изменений
`--changes`	Вывести изменения (по умолчанию)
`--sort <order>`	Сортировка по `recent` (по умолчанию) или `name`
`--json`	Вывод в формате JSON

Примеры:

bash

# Вывод всех активных изменений
openspec list

# Вывод всех спецификаций
openspec list --specs

# JSON-вывод для скриптов
openspec list --json

Вывод (текст):

Active changes:
  add-dark-mode     UI theme switching support
  fix-login-bug     Session timeout handling

`openspec view`

Отображение интерактивной панели для просмотра спецификаций и изменений.

openspec view

Открывает текстовый интерфейс для навигации по спецификациям и изменениям вашего проекта.

`openspec show`

Отображение подробной информации об изменении или спецификации.

openspec show [item-name] [options]

Аргументы:

Аргумент	Обязательный	Описание
`item-name`	Нет	Имя изменения или спецификации (запрашивается, если не указано)

Параметры:

Параметр	Описание
`--type <type>`	Указать тип: `change` или `spec` (определяется автоматически, если однозначно)
`--json`	Вывод в формате JSON
`--no-interactive`	Отключить запросы

Параметры для изменений:

Параметр	Описание
`--deltas-only`	Показать только дельта-спецификации (в режиме JSON)

Параметры для спецификаций:

Параметр	Описание
`--requirements`	Показать только требования, исключить сценарии (в режиме JSON)
`--no-scenarios`	Исключить содержимое сценариев (в режиме JSON)
`-r, --requirement <id>`	Показать конкретное требование по индексу, начиная с 1 (в режиме JSON)

Примеры:

bash

# Интерактивный выбор
openspec show

# Показать конкретное изменение
openspec show add-dark-mode

# Показать конкретную спецификацию
openspec show auth --type spec

# JSON-вывод для парсинга
openspec show add-dark-mode --json

Команды валидации

`openspec validate`

Проверка изменений и спецификаций на наличие структурных ошибок.

openspec validate [item-name] [options]

Аргументы:

Аргумент	Обязательный	Описание
`item-name`	Нет	Конкретный элемент для проверки (запрашивается, если не указано)

Параметры:

Параметр	Описание
`--all`	Проверить все изменения и спецификации
`--changes`	Проверить все изменения
`--specs`	Проверить все спецификации
`--type <type>`	Указать тип при неоднозначности имени: `change` или `spec`
`--strict`	Включить строгий режим валидации
`--json`	Вывод в формате JSON
`--concurrency <n>`	Максимальное количество параллельных проверок (по умолчанию: 6, или переменная окружения `OPENSPEC_CONCURRENCY`)
`--no-interactive`	Отключить запросы

Примеры:

bash

# Интерактивная валидация
openspec validate

# Проверка конкретного изменения
openspec validate add-dark-mode

# Проверка всех изменений
openspec validate --changes

# Проверка всего с JSON-выводом (для CI/скриптов)
openspec validate --all --json

# Строгая валидация с увеличенным параллелизмом
openspec validate --all --strict --concurrency 12

Вывод (текст):

Validating add-dark-mode...
  ✓ proposal.md valid
  ✓ specs/ui/spec.md valid
  ⚠ design.md: missing "Technical Approach" section

1 warning found

Вывод (JSON):

json

{
  "version": "1.0.0",
  "results": {
    "changes": [
      {
        "name": "add-dark-mode",
        "valid": true,
        "warnings": ["design.md: missing 'Technical Approach' section"]
      }
    ]
  },
  "summary": {
    "total": 1,
    "valid": 1,
    "invalid": 0
  }
}

Команды жизненного цикла

`openspec archive`

Архивировать завершённое изменение и объединить дельта-спецификации в основные спецификации.

openspec archive [change-name] [options]

Аргументы:

Аргумент	Обязательный	Описание
`change-name`	Нет	Изменение для архивации (запрашивается, если не указано)

Параметры:

Параметр	Описание
`-y, --yes`	Пропустить запросы подтверждения
`--skip-specs`	Пропустить обновление спецификаций (для изменений инфраструктуры/инструментов/документации)
`--no-validate`	Пропустить валидацию (требуется подтверждение)

Примеры:

bash

# Интерактивная архивация
openspec archive

# Архивация конкретного изменения
openspec archive add-dark-mode

# Архивация без запросов (CI/скрипты)
openspec archive add-dark-mode --yes

# Архивация изменения инструментов, не затрагивающего спецификации
openspec archive update-ci-config --skip-specs

Что делает команда:

Проверяет изменение (если не указан --no-validate)
Запрашивает подтверждение (если не указан --yes)
Объединяет дельта-спецификации в openspec/specs/
Перемещает папку изменения в openspec/changes/archive/YYYY-MM-DD-<name>/

Команды рабочего процесса

Эти команды поддерживают артефакт-ориентированный рабочий процесс OPSX. Они полезны как для людей, отслеживающих прогресс, так и для агентов, определяющих следующие шаги.

`openspec status`

Отобразить статус завершения артефактов для изменения.

openspec status [options]

Параметры:

Параметр	Описание
`--change <id>`	Название изменения (запрашивается, если не указано)
`--schema <name>`	Переопределение схемы (определяется автоматически из конфигурации изменения)
`--json`	Вывод в формате JSON

Примеры:

bash

# Интерактивная проверка статуса
openspec status

# Статус конкретного изменения
openspec status --change add-dark-mode

# JSON для использования агентами
openspec status --change add-dark-mode --json

Вывод (текст):

Change: add-dark-mode
Schema: spec-driven
Progress: 2/4 artifacts complete

[x] proposal
[ ] design
[x] specs
[-] tasks (blocked by: design)

Вывод (JSON):

json

{
  "changeName": "add-dark-mode",
  "schemaName": "spec-driven",
  "isComplete": false,
  "applyRequires": ["tasks"],
  "artifacts": [
    {"id": "proposal", "outputPath": "proposal.md", "status": "done"},
    {"id": "design", "outputPath": "design.md", "status": "ready"},
    {"id": "specs", "outputPath": "specs/**/*.md", "status": "done"},
    {"id": "tasks", "outputPath": "tasks.md", "status": "blocked", "missingDeps": ["design"]}
  ]
}

`openspec instructions`

Получить обогащённые инструкции для создания артефакта или применения задач. Используется ИИ-агентами для определения того, что нужно создать далее.

openspec instructions [artifact] [options]

Аргументы:

Аргумент	Обязательный	Описание
`artifact`	Нет	Идентификатор артефакта: `proposal`, `specs`, `design`, `tasks` или `apply`

Параметры:

Параметр	Описание
`--change <id>`	Название изменения (обязательно в неинтерактивном режиме)
`--schema <name>`	Переопределение схемы
`--json`	Вывод в формате JSON

Особый случай: Используйте apply в качестве артефакта для получения инструкций по реализации задач.

Примеры:

bash

# Получить инструкции для следующего артефакта
openspec instructions --change add-dark-mode

# Получить инструкции для конкретного артефакта
openspec instructions design --change add-dark-mode

# Получить инструкции по применению/реализации
openspec instructions apply --change add-dark-mode

# JSON для обработки агентами
openspec instructions design --change add-dark-mode --json

Вывод включает:

Содержимое шаблона для артефакта
Контекст проекта из конфигурации
Содержимое артефактов-зависимостей
Правила для каждого артефакта из конфигурации

`openspec templates`

Показать разрешённые пути шаблонов для всех артефактов в схеме.

openspec templates [options]

Параметры:

Параметр	Описание
`--schema <name>`	Схема для просмотра (по умолчанию: `spec-driven`)
`--json`	Вывод в формате JSON

Примеры:

bash

# Показать пути шаблонов для схемы по умолчанию
openspec templates

# Показать шаблоны для пользовательской схемы
openspec templates --schema my-workflow

# JSON для программного использования
openspec templates --json

Вывод (текст):

Schema: spec-driven

Templates:
  proposal  → ~/.openspec/schemas/spec-driven/templates/proposal.md
  specs     → ~/.openspec/schemas/spec-driven/templates/specs.md
  design    → ~/.openspec/schemas/spec-driven/templates/design.md
  tasks     → ~/.openspec/schemas/spec-driven/templates/tasks.md

`openspec schemas`

Вывести список доступных схем рабочего процесса с их описаниями и потоками артефактов.

openspec schemas [options]

Параметры:

Параметр	Описание
`--json`	Вывод в формате JSON

Пример:

bash

openspec schemas

Вывод:

Available schemas:

  spec-driven (package)
    The default spec-driven development workflow
    Flow: proposal → specs → design → tasks

  my-custom (project)
    Custom workflow for this project
    Flow: research → proposal → tasks

Команды схем

Команды для создания и управления пользовательскими схемами рабочего процесса.

`openspec schema init`

Создать новую локальную схему проекта.

openspec schema init <name> [options]

Аргументы:

Аргумент	Обязательный	Описание
`name`	Да	Название схемы (kebab-case)

Параметры:

Параметр	Описание
`--description <text>`	Описание схемы
`--artifacts <list>`	Идентификаторы артефактов через запятую (по умолчанию: `proposal,specs,design,tasks`)
`--default`	Установить как схему проекта по умолчанию
`--no-default`	Не предлагать установить по умолчанию
`--force`	Перезаписать существующую схему
`--json`	Вывод в формате JSON

Примеры:

bash

# Интерактивное создание схемы
openspec schema init research-first

# Неинтерактивное создание с определёнными артефактами
openspec schema init rapid \
  --description "Rapid iteration workflow" \
  --artifacts "proposal,tasks" \
  --default

Что создаётся:

openspec/schemas/<name>/
├── schema.yaml           # Определение схемы
└── templates/
    ├── proposal.md       # Шаблон для каждого артефакта
    ├── specs.md
    ├── design.md
    └── tasks.md

`openspec schema fork`

Скопировать существующую схему в ваш проект для настройки.

openspec schema fork <source> [name] [options]

Аргументы:

Аргумент	Обязательный	Описание
`source`	Да	Схема для копирования
`name`	Нет	Название новой схемы (по умолчанию: `<source>-custom`)

Параметры:

Параметр	Описание
`--force`	Перезаписать существующее назначение
`--json`	Вывод в формате JSON

Пример:

bash

# Форкнуть встроенную схему spec-driven
openspec schema fork spec-driven my-workflow

`openspec schema validate`

Проверить структуру и шаблоны схемы.

openspec schema validate [name] [options]

Аргументы:

Аргумент	Обязательный	Описание
`name`	Нет	Схема для проверки (проверяет все, если не указано)

Параметры:

Параметр	Описание
`--verbose`	Показать подробные шаги валидации
`--json`	Вывод в формате JSON

Пример:

bash

# Проверить конкретную схему
openspec schema validate my-workflow

# Проверить все схемы
openspec schema validate

`openspec schema which`

Показать, откуда разрешается схема (полезно для отладки приоритетов).

openspec schema which [name] [options]

Аргументы:

Аргумент	Обязательный	Описание
`name`	Нет	Название схемы

Параметры:

Параметр	Описание
`--all`	Вывести все схемы с их источниками
`--json`	Вывод в формате JSON

Пример:

bash

# Проверить, откуда берётся схема
openspec schema which spec-driven

Вывод:

spec-driven resolves from: package
  Source: /usr/local/lib/node_modules/@fission-ai/openspec/schemas/spec-driven

Приоритет схем:

Проект: openspec/schemas/<name>/
Пользователь: ~/.local/share/openspec/schemas/<name>/
Пакет: Встроенные схемы

Команды конфигурации

`openspec config`

Просмотр и изменение глобальной конфигурации OpenSpec.

openspec config <subcommand> [options]

Подкоманды:

Подкоманда	Описание
`path`	Показать расположение файла конфигурации
`list`	Показать все текущие настройки
`get <key>`	Получить конкретное значение
`set <key> <value>`	Установить значение
`unset <key>`	Удалить ключ
`reset`	Сбросить к значениям по умолчанию
`edit`	Открыть в `$EDITOR`
`profile [preset]`	Интерактивно настроить профиль рабочего процесса или через предустановку

Примеры:

bash

# Показать путь к файлу конфигурации
openspec config path

# Показать все настройки
openspec config list

# Получить конкретное значение
openspec config get telemetry.enabled

# Установить значение
openspec config set telemetry.enabled false

# Явно установить строковое значение
openspec config set user.name "My Name" --string

# Удалить пользовательскую настройку
openspec config unset user.name

# Сбросить всю конфигурацию
openspec config reset --all --yes

# Редактировать конфигурацию в вашем редакторе
openspec config edit

# Настроить профиль с помощью мастера на основе действий
openspec config profile

# Быстрая предустановка: переключить рабочие процессы на основные (сохраняет режим доставки)
openspec config profile core

openspec config profile начинается с краткого описания текущего состояния, затем позволяет выбрать:

Изменить доставку + рабочие процессы
Изменить только доставку
Изменить только рабочие процессы
Сохранить текущие настройки (выход)

Если вы сохраните текущие настройки, никакие изменения не будут записаны и не будет показано предложение об обновлении. Если в конфигурации нет изменений, но текущие файлы проекта не синхронизированы с вашим глобальным профилем/доставкой, OpenSpec покажет предупреждение и предложит запустить openspec update. Нажатие Ctrl+C также корректно отменяет процесс (без трассировки стека) и завершается с кодом 130. В контрольном списке рабочих процессов [x] означает, что рабочий процесс выбран в глобальной конфигурации. Чтобы применить эти выборы к файлам проекта, запустите openspec update (или выберите Применить изменения к этому проекту сейчас? при появлении запроса внутри проекта).

Интерактивные примеры:

bash

# Обновление только доставки
openspec config profile
# выбрать: Изменить только доставку
# выбрать доставку: Только навыки

# Обновление только рабочих процессов
openspec config profile
# выбрать: Изменить только рабочие процессы
# переключить рабочие процессы в контрольном списке, затем подтвердить

Утилитарные команды

`openspec feedback`

Отправить отзыв об OpenSpec. Создает задачу на GitHub.

openspec feedback <message> [options]

Аргументы:

Аргумент	Обязательный	Описание
`message`	Да	Сообщение с отзывом

Параметры:

Параметр	Описание
`--body <text>`	Подробное описание

Требования: GitHub CLI (gh) должен быть установлен и аутентифицирован.

Пример:

bash

openspec feedback "Add support for custom artifact types" \
  --body "I'd like to define my own artifact types beyond the built-in ones."

`openspec completion`

Управление автодополнением оболочки для CLI OpenSpec.

openspec completion <subcommand> [shell]

Подкоманды:

Подкоманда	Описание
`generate [shell]`	Вывести скрипт автодополнения в stdout
`install [shell]`	Установить автодополнение для вашей оболочки
`uninstall [shell]`	Удалить установленные автодополнения

Поддерживаемые оболочки: bash, zsh, fish, powershell

Примеры:

bash

# Установить автодополнение (автоопределение оболочки)
openspec completion install

# Установить для конкретной оболочки
openspec completion install zsh

# Сгенерировать скрипт для ручной установки
openspec completion generate bash > ~/.bash_completion.d/openspec

# Удалить
openspec completion uninstall

Коды выхода

Код	Значение
`0`	Успех
`1`	Ошибка (ошибка валидации, отсутствующие файлы и т.д.)

Переменные окружения

Переменная	Описание
`OPENSPEC_TELEMETRY`	Установите в `0` для отключения телеметрии
`DO_NOT_TRACK`	Установите в `1` для отключения телеметрии (стандартный сигнал DNT)
`OPENSPEC_CONCURRENCY`	Параллелизм по умолчанию для массовой валидации (по умолчанию: 6)
`EDITOR` или `VISUAL`	Редактор для `openspec config edit`
`NO_COLOR`	Отключает цветной вывод при установке

Сопутствующая документация

Команды - Слеш-команды ИИ (/opsx:propose, /opsx:apply и т.д.)
Рабочие процессы - Общие шаблоны и когда использовать каждую команду
Настройка - Создание пользовательских схем и шаблонов
Начало работы - Руководство по первоначальной настройке

Справочник по CLI ​

Сводка ​

Команды для людей и агентов ​

Команды только для интерактивного использования ​

Команды, совместимые с агентами ​

Глобальные параметры ​

Команды настройки ​

openspec init ​

openspec update ​

Команды рабочих областей ​

openspec workspace setup ​

openspec workspace list ​

openspec workspace link ​

openspec workspace relink ​

openspec workspace doctor ​

openspec workspace open ​

Команды просмотра ​

openspec list ​

openspec view ​

openspec show ​

Команды валидации ​

openspec validate ​

Команды жизненного цикла ​

openspec archive ​

Команды рабочего процесса ​

openspec status ​

openspec instructions ​

openspec templates ​

openspec schemas ​

Команды схем ​

openspec schema init ​

openspec schema fork ​

openspec schema validate ​

openspec schema which ​

Команды конфигурации ​

openspec config ​

Утилитарные команды ​

openspec feedback ​

openspec completion ​

Коды выхода ​

Переменные окружения ​

Сопутствующая документация ​

Справочник по CLI

Сводка

Команды для людей и агентов

Команды только для интерактивного использования

Команды, совместимые с агентами

Глобальные параметры

Команды настройки

`openspec init`

`openspec update`

Команды рабочих областей

`openspec workspace setup`

`openspec workspace list`

`openspec workspace link`

`openspec workspace relink`

`openspec workspace doctor`

`openspec workspace open`

Команды просмотра

`openspec list`

`openspec view`

`openspec show`

Команды валидации

`openspec validate`

Команды жизненного цикла

`openspec archive`

Команды рабочего процесса

`openspec status`

`openspec instructions`

`openspec templates`

`openspec schemas`

Команды схем

`openspec schema init`

`openspec schema fork`

`openspec schema validate`

`openspec schema which`

Команды конфигурации

`openspec config`

Утилитарные команды

`openspec feedback`

`openspec completion`

Коды выхода

Переменные окружения

Сопутствующая документация