Worksets (베타)

스토어와 그 스토어를 사용하는 저장소를 하나의 편집기 창에서 열어 에이전트가 모두 볼 수 있도록 합니다.

스토어를 사용하면 에이전트에 필요한 컨텍스트가 여러 폴더에 나뉘어 있습니다. 스펙과 변경사항은 스토어에 있고, 코드는 각 저장소에 있습니다. 하나의 저장소에서 시작된 에이전트는 해당 저장소만 읽고 grep할 수 있으므로 반쪽짜리 그림만 가지고 작업하게 됩니다.

Worksets는 OpenSpec이 이 문제를 위해 제공하는 유틸리티입니다. Workset은 함께 여는 폴더들의 저장된 이름 목록입니다. 이 페이지는 스토어가 이미 설정되어 머신에 등록되어 있다고 가정합니다. Stores (베타)에서 그 과정을 다룹니다.

작동 방식

• 무엇인지: 이름이 지정된 폴더 목록으로, 머신에만 저장됩니다. 멤버 폴더에는 아무것도 기록되지 않으며, 커밋되지도 않습니다.
• 열기 시 동작: OpenSpec이 목록에서 .code-workspace 파일을 생성하고 편집기를 실행합니다. 모든 멤버 폴더가 하나의 창에 배치됩니다.
• 제공하는 것: 편집기의 검색과 해당 창에서 실행하는 모든 에이전트가 모든 멤버 폴더를 읽을 수 있습니다. 에이전트는 하나의 세션에서 스토어의 스펙과 저장소의 코드를 모두 grep할 수 있습니다.
• 변경하지 않는 것: 명령이 사용하는 openspec/ 폴더의 위치. 이는 여전히 Where artifacts get created을 따릅니다.

설정 방법

1. Workset 저장 (머신당 한 번). 저장소와 스토어를 멤버로 나열하고, 이를 여는 도구를 지정합니다:

   # save a named list of folders you open together
   openspec workset create platform \
     --member ~/src/web-app \
     --member ~/openspec/team-plans \
     --tool code

   Saved workset 'platform' (2 members) to your machine.
   Open it any time with: openspec workset open platform

2. 열기 작업을 시작할 때마다:

   # open every member in one VS Code window
   openspec workset open platform

openspec workset list는 저장된 항목을 보여주고, openspec workset remove <name>은 멤버 폴더에 영향을 주지 않고 workset을 삭제합니다:

platform  (opens in VS Code)
  web-app     /Users/you/src/web-app
  team-plans  /Users/you/openspec/team-plans

사용법: 하나의 변경, 두 개의 폴더

add-login 변경사항이 team-plans 스토어에 있고 관련 코드가 web-app에 있다고 가정합니다. platform workset을 열고 에이전트에게 변경사항을 구현하도록 요청하세요. 하나의 세션에서 다음을 수행할 수 있습니다:

• team-plans/openspec/changes/add-login/과 그 옆의 스펙 읽기
• web-app/의 코드 편집
• web-app 내부에서 openspec 명령 실행

Workset 없이는 에이전트가 시작된 폴더만 볼 수 있습니다.

기본 제공 도구

• VS Code (--tool code) 및 Cursor (--tool cursor): 기본 내장. 각각 모든 멤버 폴더가 포함된 하나의 창을 엽니다.
• 터미널의 Claude Code 및 Codex: 해당 흐름이 재작업되는 동안 workset 열기 기능으로 일시적으로 비활성화되어 있습니다. --tool claude 또는 --tool codex는 이를 알리는 오류와 함께 중지되며 VS Code 또는 Cursor를 가리킵니다.
• 기타 편집기: CLI settings (config.json)의 openers 키 아래에 추가하세요.