초안

초안은 대화창이 따로 있는 프로젝트 복사본입니다. 나와 초대한 사람이 여기서 바꿔 보고, 내가 승인해야 원래 프로젝트(앱에서는 메인이라고 부릅니다)에 반영됩니다.

다른 사람이나 그 사람의 에이전트가 내 파일을 직접 건드리지 않고 프로젝트를 고치게 하고 싶을 때 씁니다. git을 몰라도 됩니다. 복사와 병합은 앱이 알아서 합니다.

시작하기 전에

초안 기능을 쓰려면 컴퓨터에 Git 2.40 이상이 있어야 합니다. 프로젝트가 git 저장소가 아니어도 마찬가지입니다. Git이 없으면 초안 창에 “초안 기능을 쓰려면 이 컴퓨터에 Git 2.40 이상이 필요합니다. Git을 설치한 뒤 앱을 다시 시작하세요.”라고 나옵니다.

Windows에서는 Git을 설치한 뒤 TokenWork를 다시 시작하세요. 앱은 한 번 찾은 Git 위치를 다시 시작할 때까지 그대로 씁니다.

초안 만들기

복사할 프로젝트의 세션을 엽니다.
메시지 입력창 아래의 초안을 누릅니다.
새 초안을 누릅니다.
초안 이름을 40자 이내로 입력합니다. \ / : * ? " < > |는 쓸 수 없습니다.
메인에서 가져올 파일에서 초안이 돌아가는 데 필요한 파일을 고릅니다. 복사되는 파일을 참고하세요.
초안 만들기를 누릅니다.

“초안을 만들었습니다.”가 뜨고, 사이드바의 원래 세션 아래에 초안 세션이 생깁니다. 열어서 평소처럼 에이전트와 대화하면 됩니다.

그 프로젝트에서 에이전트가 작업 중이면 초안을 만들 수 없습니다. 작업이 끝난 뒤 다시 시도하세요.

복사되는 파일

초안은 만드는 순간 디스크에 저장된 파일로 시작합니다. 편집기에서 열어 둔 파일은 먼저 저장하세요.

저장된 프로젝트 파일은 모두 복사됩니다. 프로젝트에서 git이 무시하도록 정한 파일만 빠집니다.
node_modules/, .venv/, __pycache__/ 같은 폴더는 직접 고르지 않으면 건너뜁니다.
바로 가기, 정션, 심볼릭 링크처럼 다른 곳을 가리키는 폴더도 건너뜁니다.

.env처럼 git이 무시하는 파일은 비밀번호나 API 키가 들어 있어도 메인에서 가져올 파일에서 직접 골라야 복사됩니다. 처음에는 아무것도 선택돼 있지 않습니다. 비밀값이 있을 수 있음 표시가 붙은 파일에는 비밀번호나 키가 들어 있을 가능성이 큽니다. 용량 큼, 보통 필요 없음 표시가 붙은 폴더는 대개 빼도 됩니다. 목록에 없는 경로는 다른 경로에 쉼표로 구분해 적습니다.

초대한 사람은 복사된 파일을 모두 읽을 수 있습니다. 누군가를 초대할 생각이라면 비밀값이 든 파일은 빼 두세요. git이 무시하지 않는 파일은 목록에 나오지 않으므로 비밀값이 있어도 그대로 복사됩니다.

사람 초대하기

초안을 누르고 목록에서 초안을 찾습니다.
초대를 눌러 초대 링크를 만듭니다.
함께 작업할 사람에게 링크를 보냅니다.

초대받은 사람은 초안에서 파일을 고치고, 설정을 적용하고, 반영을 요청할 수 있습니다. 메인 반영 승인은 나만 할 수 있습니다.

상대는 공유 세션을 열 때와 같은 방법으로 자기 TokenWork에서 링크를 엽니다(에이전트 협업 참고). 이후 상대가 보낸 메시지는 내 초안 세션에서 한 번에 하나씩 실행됩니다. 상대 쪽 공유 세션에는 초안 패널이 생기고, 여기서 설정 적용과 메인에 반영 요청을 할 수 있습니다.

초안 아래에는 사용 중인 초대 링크와 링크마다 만든 날짜가 나옵니다. 누구에게 보낸 링크인지는 표시되지 않습니다. 링크를 취소하려면 회수를 누릅니다.

상대의 에이전트는 git에 푸시하거나 초안 밖 폴더에 손댈 수 없습니다. TokenWork가 이런 요청을 알아서 거절하므로 나에게 묻는 창도 뜨지 않습니다.

설정 적용

누군가 초안의 OpenCode 설정(MCP 서버, 플러그인, 에이전트)을 바꿨다면 초안 카드에서 설정 적용을 누릅니다. 다음 턴부터 반영됩니다. 메인과 다른 초안은 그대로 돌아갑니다.

초안을 메인에 반영하기

나 또는 초대한 사람이 메인에 반영 요청을 누릅니다. 초대한 사람이 요청하면 “초안 반영 요청” 알림이 오고, 초안 버튼에 승인을 기다리는 요청 수가 표시됩니다.

요청을 검토하는 방법은 다음과 같습니다.

초안을 누르고 해당 초안의 메인 반영 검토를 누릅니다.
바뀐 파일 목록을 확인합니다. 파일마다 추가, 수정, 삭제 중 하나가 표시됩니다. 파일을 누르면 바뀐 내용이 보입니다.
경고 표시가 붙은 파일은 꼭 살펴보세요. 이 컴퓨터에서 실행되는 설정이나 스크립트를 바꾸는 파일입니다.
승인하고 병합 또는 거절을 누릅니다.

승인하면 TokenWork는 바뀐 파일만 메인에 쓰고, 초안에서 한 작업의 요약을 메인 대화에 붙인 뒤 초안을 닫습니다. 초안 대화는 보관함에 남습니다. 초대받은 사람에게는 초안이 반영되어 닫혔다고 표시됩니다. 계속 작업하려면 새 초안에 다시 초대받아야 합니다.

초안에서 바뀐 파일이 없으면 승인했을 때 요약만 메인 대화에 붙습니다.

거절할 때는 사유를 적을 수 있습니다. 요청한 사람과 초안 대화에 사유가 보입니다. 초안은 열린 채로 남으니 작업을 이어 갈 수 있습니다.

초안 하나에는 열린 반영 요청이 한 번에 하나만 있습니다. 메인이나 초안에서 에이전트가 작업 중이면 승인할 수 없습니다. 반영이 도중에 멈췄다면 문제 해결을 참고하세요.

양쪽에서 같은 부분을 고쳤을 때

메인과 초안이 파일의 같은 부분을 고쳤다면 메인에는 아무것도 쓰지 않습니다. 상태가 충돌로 바뀌고, 두 내용이 <<<<<<<와 >>>>>>> 표시와 함께 초안의 파일에 들어갑니다.

초안 열어서 해결을 누릅니다. 초안 세션이 열리고, 맞는 내용만 남기고 표시를 지워 달라는 메시지가 입력창에 채워집니다.
그 메시지를 보냅니다.
에이전트가 정리를 마치면 다시 요청을 눌러 미리보기를 새로 만듭니다.
다시 검토하고 승인합니다.

정리

초안 카드의 정리를 누르면 초안 파일이 지워집니다. 메인에 반영하지 않은 변경이 있으면 확인 창에 사라질 파일 수가 나옵니다. 초안 파일 지우기를 누르면 진행됩니다. 대화는 보관함에 남습니다.

닫힌 초안은 목록에서 삭제를 누를 때까지 목록에 남아 있습니다.

초안