Cloud 가이드

Cloud는 작업을 원격으로 실행합니다. 저장소를 선택하여 작업을 시작하거나 기존 로컬 작업을 클라우드로 옮긴 뒤 Cloud를 지원하는 사용 가능한 클라이언트에서 작업을 확인하세요.

이 가이드는 데스크톱 앱을 주요 인터페이스로 사용합니다. 로컬 작업을 Cloud로 옮기고 전송 상태를 확인하는 CLI 명령도 포함합니다.

flowchart TD
    A["계정 및 저장소 접근 확인"] --> B{"어디에서 시작하나요?"}
    B --> C["저장소를 선택하고 클라우드 작업 시작"]
    B --> D["기존 로컬 작업 열기"]
    D --> E["전송할 대화 및 미커밋 변경 검토"]
    C --> F["Cloud가 작업을 준비하고 실행"]
    E --> F
    F --> G["진행 상황 확인, 맥락 추가 및 결과 검토"]
    G --> H["작업 개선 또는 PR로 전달"]

1. 시작하기 전에

1.1 계정 및 클라이언트

이 가이드의 예시는 GitHub 저장소를 사용합니다. 설치 및 로그인은 데스크톱 가이드를 참조하세요.

1.2 시작 방식 선택

2. 저장소 연결 및 요구사항 확인

2.1 GitHub 연결

1. 데스크톱 앱에서 프로젝트 선택기를 열고 Cloud를 찾으세요.
2. Cloud를 사용할 수 없다면 옆의 설정 버튼을 클릭하여 GitHub 연결 페이지를 여세요.
3. 페이지의 안내에 따라 GitHub를 승인하세요.
4. 프로젝트 선택기로 돌아와 Cloud를 열고 대상 저장소가 나열되는지 확인하세요.

Search repos로 저장소를 찾으세요. 저장소가 없으면 연결된 GitHub 계정과 접근이 승인된 저장소를 확인하세요.

2.2 저장소 및 브랜치 확인

저장소를 선택하면 Remy는 기본 브랜치에서 시작합니다. 다른 브랜치를 사용하려면 브랜치 선택기를 열고 작업을 시작할 브랜치를 선택하세요.

2.3 Cloud의 환경 준비 방식

작업을 제출하면 Cloud가 작업 공간을 준비하고 저장소 코드를 가져와 필요에 따라 실행을 시작합니다. 이 워크플로에서는 별도의 이름을 가진 클라우드 환경을 만들 필요가 없습니다.

컴퓨터에 설치된 의존성, 로컬 개발 서버 및 로컬 자격 증명이 Cloud에도 있다고 가정하지 마세요. 작업에 특별한 의존성이 필요하면 프로젝트 문서나 작업 설명에 준비 및 확인 방법을 설명하세요.

먼저 저장소의 README와 프로젝트 지침을 읽으세요.
의존성 설치, 프로젝트 실행 및 테스트 실행 방법을 확인하세요.
환경에 필수 요소가 없으면 누락된 항목을 식별하고 관련 오류를 포함하세요.
가능한 점검을 실행하고 실행할 수 없는 점검은 별도로 나열하세요.

3. Cloud에서 바로 작업 시작

3.1 저장소 선택 및 작업 보내기

1. 새 채팅을 시작하고 프로젝트 선택기에서 Cloud를 여세요.
2. 대상 저장소를 찾아 선택하고 브랜치를 확인하세요.
3. 실행 설정에 Send to cloud가 표시되는지 확인하세요.
4. 사용 가능한 모델을 고르고 작업을 설명한 뒤 보내세요.
5. 초기화 및 실행을 기다린 뒤 진행 상황과 결과를 검토하세요.

먼저 계획을 검토하려면 작업 제출 전에 실행 메뉴에서 Plan before editing을 켜세요. 계획을 읽고 확인하거나 채팅에서 원하는 변경을 설명하세요.

3.2 요구사항 명확히 하기

이 예시를 프로젝트에 맞게 바꾸세요.

주문 목록에서 필터 변경 시 발생하는 페이지 나누기 문제를 찾아 수정하세요.

요구사항:
1. 먼저 저장소 문서와 관련 지침을 읽으세요.
2. 필터링, 페이지 나누기 및 직접 관련된 로직만 변경하세요.
3. 프로젝트의 기존 스타일과 테스트 규칙을 따르세요.
4. 관련 테스트를 추가하고 실행하세요.
5. 변경한 파일, 점검 결과 및 남은 작업을 요약하세요.

PR은 병합하지 마세요.

3.3 텍스트 메시지 및 로컬 첨부 파일

Cloud에 직접 보내는 작업 메시지는 현재 텍스트만 허용합니다. 로컬 첨부 파일, 폴더 참조 및 로컬 코드 참조는 이 메시지와 함께 보낼 수 없습니다.

4. 로컬 작업을 Cloud로 이동

4.1 데스크톱 앱에서 전송 시작

1. 계속할 로컬 채팅을 열고 현재 프로젝트와 작업을 확인하세요.
2. 현재 로컬 실행이 끝날 때까지 기다리세요.
3. 채팅 탭의 메뉴를 열고 Move to Cloud를 선택하세요.
4. 미커밋 파일이 있으면 파일 수, 목록 및 예상 전송 크기를 검토한 뒤 포함 여부를 선택하세요.
5. 표시된 저장소, 커밋 및 기타 확인 정보를 점검하고 안내를 따르세요.
6. 전송이 성공할 때까지 기다린 뒤 원래 작업에서 클라우드 실행을 확인하세요.

GitHub가 승인되지 않았다면 다시 시도하기 전에 설정 항목에서 승인을 완료하세요.

4.2 미커밋 변경 포함 여부 선택

Include uncommitted changes?가 표시되면 다음을 참고하세요.

이 선택은 미커밋 변경의 포함 여부를 결정합니다. 진행 전에 표시된 파일 범위를 검토하세요. 전체 로컬 폴더가 업로드된다고 가정하지 마세요.

4.3 전송 후 달라지는 점

전송 성공이 작업 완료를 뜻하지는 않습니다. Cloud로 이동한 뒤 실행을 기다리고 결과를 검토하며 후속 작업을 처리하세요.

4.4 CLI에서 전송 시작

CLI에 로그인한 터미널에서 대상 프로젝트의 채팅을 나열하세요.

remy --workspace "/path/to/project" history list

/path/to/project를 실제 프로젝트 경로로, 아래의 CHAT_ID를 해당 대화 ID로 바꾸세요.

미커밋 변경 포함:

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --include-workspace --message "클라우드에서 남은 점검을 계속하고 결과를 보고하세요."

미커밋 변경을 로컬에 유지:

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --exclude-workspace --message "커밋된 코드를 사용하여 클라우드에서 작업을 계속하세요."

작업에 맞는 명령을 선택하세요. 작업 디렉터리에 미커밋 변경이 없으면 --include-workspace와 --exclude-workspace를 모두 생략할 수 있습니다.

CLI가 전송 미리 보기를 표시합니다. 계정 범위, 저장소, 브랜치, 커밋 및 파일 범위를 확인한 뒤 yes를 입력하여 확인하세요.

4.5 전송 확인 또는 취소

전송이 아직 진행 중이면 상태를 확인하세요.

remy --workspace "/path/to/project" cloud status --chat-id "CHAT_ID"

handoff ID가 있으면 명시적으로 지정할 수 있습니다.

remy --workspace "/path/to/project" cloud status --chat-id "CHAT_ID" --handoff-id "HANDOFF_ID"

HANDOFF_ID를 해당 작업에서 반환한 ID로 바꾸세요. 업로드 후 연결이 끊기거나 결과를 알 수 없으면 새 전송을 시작하지 말고 먼저 같은 전송을 확인하세요.

클라우드 작업이 활성화되기 전에 전송을 취소하려면 다음을 실행하세요.

remy --workspace "/path/to/project" cloud cancel --chat-id "CHAT_ID" --handoff-id "HANDOFF_ID"

이 명령은 클라우드 작업이 활성화되지 않은 전송만 취소합니다. 이미 활성화된 작업은 취소할 수 없습니다. Cloud에서 이미 실행 중인 작업은 데스크톱 앱에서 열고 작업의 중지 제어 기능을 사용하세요.

CLI의 cloud status 명령은 전송을 확인합니다. 전체 작업 진행 상황, 대화 계속하기 및 PR 작업에는 데스크톱 작업 인터페이스를 사용하세요.

5. 작업 확인 및 여러 기기에서 작업

5.1 현재 단계 이해

중지를 요청한 뒤 작업 상태가 업데이트될 때까지 기다리고 클라우드 실행이 끝났는지 확인하세요.

5.2 원래 작업에서 계속하기

결과를 개선하려면 같은 클라우드 작업을 열고 바꿀 내용을 설명하세요.

이제 필터를 바꾸면 목록이 1페이지로 돌아가지만 새로 고쳐지지 않습니다.
새로 고침 로직만 수정하고 이미 완료된 변경은 보존하세요.
관련 테스트를 추가하고 실행한 뒤 결과를 요약하세요.

PR은 병합하지 마세요.

네트워크 중단 후에는 원래 작업을 다시 열고 현재 상태와 최신 응답을 확인한 뒤 메시지를 다시 보낼지 결정하세요. 작업 목록 새로 고침이 실패하면 마지막으로 가져온 기록이 계속 표시될 수 있습니다.

5.3 다른 기기에서 계속하기

1. 다른 기기의 Remy Desktop에 같은 계정으로 로그인하고 동일한 팀 범위인지 확인하세요.
2. 사이드바에서 클라우드 작업을 찾으세요.
3. 열고 최신 메시지와 상태가 로드될 때까지 기다리세요.
4. 같은 작업에서 결과를 검토하거나 요구사항을 추가하세요.

작업을 시작한 컴퓨터가 온라인 상태를 유지할 필요는 없습니다. 데스크톱 앱을 닫거나 오프라인이 되거나 컴퓨터를 종료해도 Cloud 작업은 계속할 수 있습니다. 답변이 필요한 질문은 사용자의 응답을 기다립니다.

Cloud를 지원하는 클라이언트를 사용하여 여러 기기에서 작업하세요.

6. 결과 검토 및 전달

6.1 작업 결과 확인

작업 결과나 생성된 PR이 테스트 및 실제 동작 확인을 대신하지는 않습니다.

6.2 PR로 작업 전달

PR이 필요하면 작업에 명시하세요. 예를 들면 다음과 같습니다.

완료한 변경 사항의 PR을 준비하세요.
해결한 문제, 주요 변경, 실행한 점검 및 남은 작업을 설명하세요.
이 작업에 이미 PR이 있으면 해당 PR을 업데이트하세요.

병합하지 마세요.

작업에서 PR을 만들면 Draft PR 또는 PR 카드가 나타납니다. 링크를 클릭하여 브라우저에서 PR을 열고 작업 브랜치, 대상 브랜치 및 실제 diff를 검토하세요.

Remy에서 병합하려면 먼저 PR을 검토한 뒤 카드의 Merge PR을 선택하세요. 진행 전에 확인 대화상자에서 소스 및 대상 브랜치를 확인하세요. 병합은 원격 저장소를 변경합니다. 반환된 상태로 결과를 확인하세요.

6.3 로컬 폴더는 자동 업데이트되지 않음

Cloud 결과는 로컬 작업 디렉터리로 자동 동기화되지 않습니다. PR 병합 후 또는 로컬 작업을 재개하려는 경우 프로젝트의 일반적인 Git 워크플로로 코드를 가져와 확인하세요.

로컬 Changes 패널에 클라우드 작업의 최신 변경이 반드시 표시되는 것은 아닙니다.

7. 문제 해결 및 알려진 제한 사항

7.1 접근, 실행 및 결과

7.2 현재 경계

• 로컬에서 클라우드로 전송할 때는 미리 보기와 선택한 범위를 따릅니다. 컴퓨터 전체나 로컬 런타임 환경을 복사하지 않습니다.
• Cloud 작업을 시작하거나 계속하는 메시지는 현재 텍스트만 허용합니다.
• 전송 시 선택에 따라 로컬 미커밋 파일의 포함 여부가 결정됩니다.
• CLI에서 전송을 확인하는 것은 클라우드 작업의 실행을 확인하는 것과 다릅니다.
• Cloud 결과는 로컬로 자동 동기화되지 않습니다. 실제 코드, 점검 결과 및 PR 상태로 전달 여부를 확인하세요.

8. 도움 받기 및 더 알아보기

8.1 문제 보고

관련 작업의 Send feedback을 사용하세요. CLI 피드백 명령은 CLI 가이드를 참조하세요.

작업 시작, 로컬 작업의 Cloud 이동, 작업 확인 또는 PR 전달 중 어느 단계에서 문제가 발생했는지 명시하세요. 저장소와 브랜치, 작업 또는 handoff ID 및 오류 메시지를 포함하세요.

작업을 열거나 피드백 항목을 사용할 수 없으면 support@corepass.com으로 지원팀에 문의하세요.

8.2 더 알아보기