워크스페이스

데스크톱 앱은 AI 에이전트와 하루 종일 반복하는 루프, 즉 요청을 보내고 결과를 확인하고 변경 사항을 검토하는 과정을 중심으로 만들어진 게임 개발 워크스페이스입니다. 이 페이지에서는 프로젝트 창, 세션과 팬, 파일 미리보기, Explorer, Search, Source Control이 있는 오른쪽 패널, 그리고 워크스페이스를 자신에게 맞게 설정하는 방법을 설명합니다.

프로젝트당 하나의 창#

VS Code에서처럼 각 프로젝트는 자체 창에서 열립니다. 앱을 다시 실행하면 열려 있던 모든 프로젝트 창이 각자의 크기, 위치, 사이드 패널, 팬 레이아웃과 함께 복원됩니다.

빈 창은 최근 프로젝트, Open folder…, Create new project가 있는 런처입니다. Ctrl-클릭(Windows, Linux) 또는 Cmd-클릭(macOS)하면 현재 창을 대체하는 대신 새 창에서 프로젝트가 열립니다. 프로젝트 열기와 생성에 관해서는 Projects and engines를 참고하세요.

팬에 배치된 세션#

창의 중앙은 팬 레이아웃입니다. 다음을 할 수 있습니다:

• 여러 세션을 탭으로 열어 두거나, 세로 또는 가로로 나란히 분할할 수 있습니다.
• 하나의 팬을 최대화하거나 레이아웃 위에 띄울 수 있습니다.
• 세션 목록에서 세션을 레이아웃으로 바로 끌어다 놓을 수 있습니다.

백그라운드의 세션은 계속 스트리밍되며, 레이아웃은 프로젝트별로 저장됩니다. 각 팬은 자체 모델, 추론 강도, 에이전트를 유지하므로 한 팬에서는 큰 모델로 기능을 계획하고 다른 팬에서는 빠른 모델로 간단한 질문에 답할 수 있습니다. Agents and models를 참고하세요.

세션 그룹#

사이드바는 세션을 그룹으로 정리하며, 그룹은 생성, 이름 변경, 색상 지정, 순서 변경이 가능합니다. 그룹 구성은 프로젝트와 함께 커밋되므로 저장소를 클론한 팀원도 동일한 레이아웃을 보게 됩니다. 각 행에는 AI가 무엇을 하는지와 얼마나 오래 작업했는지가 표시되며, 검색 필드로 이름이나 그룹 기준으로 세션을 필터링할 수 있습니다. 완료로 표시한 세션은 복원하거나 영구적으로 삭제할 수 있습니다.

긴 대화에서는 프롬프트 내비게이터로 이전 메시지로 바로 이동할 수 있으며, 마우스를 올리면 미리보기가 표시됩니다.

채팅 옆에서 파일 미리보기#

에이전트가 파일을 생성하거나 변경하면 세션 옆의 미리보기 팬에서 열어 보세요. 채팅 메시지의 파일 경로는 클릭할 수 있으며, 클릭하면 파일이 열리고 메시지에 줄 번호가 있으면 해당 줄로 이동합니다.

한 번 클릭하면 임시 미리보기가 열리고, 두 번 클릭하면 미리보기가 고정됩니다. 파일이 디스크에서 변경되면 미리보기가 다시 로드되므로, 더 어두운 텍스처를 요청하면 에이전트가 파일을 쓰는 즉시 열려 있는 미리보기가 갱신됩니다. 패키지는 다른 파일 형식을 위한 자체 미리보기와 편집기를 추가할 수 있습니다.

오른쪽 패널: Explorer, Search, Source Control#

오른쪽 패널에는 세 개의 탭이 있습니다:

• Explorer: Git 상태가 표시되는 실시간 트리로 프로젝트 파일을 보여주며, 인라인 이름 변경과 생성, 파일을 채팅 작성창으로 끌어다 놓기를 지원합니다.
• Search: 포함 및 제외 glob을 사용하는 콘텐츠 검색과 모든 일치 항목 바꾸기.
• Source Control: 브랜치, 앞서감/뒤처짐 수, diffstat을 보여주며 여기서 커밋과 풀을 할 수 있습니다.

Source Control에서 변경된 파일을 클릭하면 diff로 열립니다. 이미지의 경우 diff가 나란히 비교 보기로 표시되므로, 커밋하기 전에 텍스처가 어떻게 바뀌었는지 정확히 확인할 수 있습니다.

패키지는 사이드 패널에 자체 탭을 추가할 수 있습니다. 예를 들어 Knowledge Base 패키지는 Knowledge Base 뷰를 추가합니다.

CLI에도 동일한 작업이 명령으로 있습니다. /git은 status, stage, commit, discard, pull, push에, /search와 /replace는 프로젝트 검색에, /file은 파일 변경에, /files는 채팅에서 언급된 파일에 사용합니다. CLI reference를 참고하세요.

루프: 요청, 미리보기, 검토#

1. 요청을 보냅니다. 예: "Meadow Isle을 밤 잔디 텍스처로 바꾸고 활공 낙하를 조금 느리게 해줘."
2. 채팅 옆에서 결과를 확인합니다. 텍스처는 이미지 미리보기에서, 캐릭터는 3D 미리보기에서, 음악은 오디오 미리보기에서 볼 수 있습니다.
3. Source Control을 열어 이전 텍스처와 새 텍스처를 비교하고 코드 diff를 읽어 봅니다.
4. 만족스러우면 커밋하고, 아니면 다른 변경을 요청합니다.

도구, 상태 표시줄, 명령 팔레트#

• 작성창 위의 Tools row는 세션의 도구를 켜고 끕니다. Blender, Music, Knowledge Base, Image Gen, Video, Tripo, Cloud generation 및 설치한 다른 패키지의 도구가 포함됩니다.
• 하단의 status bar는 Knowledge Base 노트 개수 같은 패키지 항목과 Packages 창을 여는 패키지 아이콘을 표시합니다.
• command palette는 앱과 패키지의 명령을 나열합니다.
• 패키지는 작성창 툴바에 버튼을, 마우스 오른쪽 버튼 메뉴에 항목을 추가할 수 있습니다.

나에게 맞게 설정하기#

워크스페이스에는 중성적인 검정 Dark부터 차콜색 Carbon, 밝은 테마까지 여섯 가지 테마가 있습니다. Settings, Appearance에서 선택하세요. 창이 좁아지면 작성창이 정해진 순서대로 컨트롤을 숨기므로 작게 분할해도 계속 사용할 수 있습니다. 짧은 인앱 팁은 기능이 처음 유용해질 때 소개해 줍니다. Settings, General에서 초기화할 수 있습니다.

더 알아보기#

• one workspace for panes, previews and Git 글에서 데모 게임으로 전체 루프를 보여줍니다.
• Packages에서 패널, 미리보기, 도구를 추가하는 방법을 설명합니다.