OpenSpec

Набір робочих середовищ (beta) ​

Відкрийте сховище та репозиторії, які його використовують, в одному вікні редактора, щоб агент бачив і те, і те.

Зі сховищем контекст, який потрібен вашому агенту, розподілений між папками. Специфікації та зміни зберігаються в сховищі, а код — у кожному репозиторії. Агент, запущений в одному репозиторії, може читати та пошукати за цим репозиторієм і нічим іншим, тому він працює лише на основі частини інформації.

Набори робочих середовищ — це інструмент, який OpenSpec надає для цієї мети. Набір робочих середовищ — це збережений іменований список папок, які ви відкриваєте разом. На цій сторінці припускається, що сховище вже налаштовано та зареєстровано на вашому комп’ютері. Це описано на сторінці Сховища (beta).

Як це працює ​

  • Що це таке: іменований список папок, збережений лише на вашому комп’ютері. Нічого не записується в папки-учасниці, і нічого не коммітиться.
  • Що відбувається при відкритті: OpenSpec генерує файл .code-workspace на основі списку та запускає ваш редактор з ним. Кожен учасницький папка знаходиться в одному вікні.
  • Що ви отримуєте: пошук у вашому редакторі та будь-який агент, запущений у цьому вікні, може читати кожен учасницький папку. Агент може виконувати пошук у специфікаціях сховища та коді репозиторію в одній сесії.
  • Що це не змінює: яка папка openspec/ використовується командою. Це досі визначається за Туди, куди створюються артефакти.

Налаштування ​

  1. Збережіть набір робочих середовищ (один раз на комп’ютері). Вкажіть репозиторій та сховище як учасників, а також інструмент для їх відкриття:

    bash
    # збережіть іменований список папок, які ви відкриваєте разом
openspec workset create platform \
  --member ~/src/web-app \
  --member ~/openspec/team-plans \
  --tool code
    yaml
    Збережено набір робочих середовищ 'platform' (2 учасники) на вашому комп’ютері.
Відкрийте його будь-коли за допомогою: openspec workset open platform

  2. Відкрийте його, коли починаєте роботу:

    bash
    # відкрийте кожного учасника в одному вікні VS Code
openspec workset open platform

Команда openspec workset list показує, що ви зберегли, а openspec workset remove <name> видаляє набір робочих середовищ, не торкаючись учасницьких папок:

yaml
platform  (відкривається в VS Code)
  web-app     /Users/you/src/web-app
  team-plans  /Users/you/openspec/team-plans

Використання: одна зміна, дві папки ​

Припустімо, що зміна add-login зберігається в сховищі team-plans, а код для неї знаходиться в web-app. Відкрийте набір робочих середовищ platform і попросіть вашого агента реалізувати зміну. В одній цій сесії він зможе:

  • читати team-plans/openspec/changes/add-login/ та специфікації поруч
  • редагувати код у web-app/
  • виконувати команди openspec зсередини web-app

Без набору робочих середовищ агент бачить лише ту папку, в якій його запущено.

Доступні інструменти з коробки ​

  • VS Code (--tool code) та Cursor (--tool cursor): вбудовані. Кожен відкриває одне вікно з кожним учасницьким папкою.
  • Claude Code та Codex у терміналі: тимчасово вимкнені як відкривачі наборів робочих середовищ, поки цей процес перебудовується. --tool claude або --tool codex зупиняється з помилкою, яка це повідомляє та вказує на VS Code або Cursor.
  • Інші редактори: додайте їх під ключем openers у Налаштування CLI (config.json).