프로젝트 관리

Cocode IDE 에서 프로젝트는 사이드바 「프로젝트」 목록에 올라 있는 폴더 하나입니다. 열려 있는 프로젝트가 채팅의 생성 위치이고 코드 모드가 다루는 폴더입니다. 같은 경로를 두 번 넣어도 목록에는 한 줄만 생기고(경로 글자가 같을 때만 같은 프로젝트로 봅니다 — 심볼릭 링크를 풀지 않고, macOS · Linux 에서는 대소문자도 구분합니다), 목록은 넣은 순서대로 보입니다.

프로젝트를 추가하는 길

입구는 여럿이고, 어느 쪽으로 열든 그 폴더는 프로젝트 목록에 들어갑니다.

• 펼친 사이드바의 「프로젝트」 제목 줄에 있는 「프로젝트 추가」 단추(접힌 사이드바에는 없습니다).
• 채팅 화면. 열린 프로젝트가 없으면 「프로젝트 추가」 단추가 보이고, 프로젝트가 열려 있으면서 대화가 비어 있으면 첫 화면의 「이미 있는 프로젝트로 시작」 아래에 세 타일(「폴더 찾아보기」 · 「URL에서 복제」 · 「빈 프로젝트 만들기」)이 보입니다. 모두 같은 「프로젝트 추가」 대화상자를 엽니다.
• 메뉴의 「폴더 열기…」(Windows · Linux 의 창 안 메뉴에서는 «폴더 열기…» 로 보입니다). 대화상자 없이 곧바로 운영체제의 폴더 선택기를 엽니다. 코드 모드에서 열린 프로젝트가 없을 때 탐색기에 보이는 「폴더 열기…」 단추와 빈 편집기의 「파일 열기…」 단추도 같은 길입니다.

「프로젝트 추가」 대화상자는 바깥을 눌러도 닫히지 않고, 오른쪽 위의 「닫기」 단추나 Esc 키로 닫습니다. 입력해 둔 URL이 실수 한 번에 사라지지 않게 한 동작입니다. 복제하는 중에 대화상자를 닫으면 복제도 멈춥니다. 이 대화상자로 추가한 폴더는 코드 모드로 열립니다(이미 열려 있는 폴더면 모드가 그대로이고, 지금 프로젝트의 저장 확인에서 취소하면 목록에만 들어갑니다).

폴더 찾아보기

가장 위의 큰 단추 「폴더 찾아보기」(「로컬 프로젝트, Git 저장소, 또는 저장소가 여러 개 든 폴더」)는 운영체제의 폴더 선택기를 엽니다. 처음 보이는 위치는 홈 폴더 아래 Projects 폴더입니다(없으면 홈 폴더). 대화상자가 열리면 이 단추에 초점이 가 있어서 Enter 키로 바로 누를 수 있습니다.

URL에서 복제

「다른 방법」 아래의 「URL에서 복제」(「원격 Git 저장소를 내려받아 목록에 추가합니다」)는 대화상자를 열면 처음부터 펼쳐져 있습니다.

1. 「저장소 URL」에 주소를 넣습니다. https://… · ssh://… · 사용자@호스트:경로(예: git@github.com:team/app.git) 꼴만 받고, http:// 와 git:// 는 받지 않습니다. 형식이 틀리면 「저장소 주소를 확인하세요」가 나옵니다.
2. 「저장 위치」는 URL 을 넣으면 홈 폴더 아래 Projects(없으면 홈 폴더 바로 아래)에 저장소 이름을 붙인 경로로 저절로 채워집니다. 직접 고치거나 「변경…」으로 상위 폴더를 고를 수 있습니다. 없는 경로이거나 비어 있는 폴더여야 합니다. 이미 파일이 있으면 git 을 실행하기 전에 「저장 위치에 이미 파일이 있습니다」가 나옵니다.
3. 「복제하고 열기」를 누르면 진행 막대와 진행 문구가 나옵니다. 중간에 「취소」할 수 있습니다. 끝나면 복제한 폴더가 목록에 추가되어 열립니다.

실패하면 「복제하지 못했습니다 (종료 코드 N)」와 git 이 남긴 마지막 줄이, git 이 없으면 「git 을 실행하지 못했습니다」가 나옵니다.

새 프로젝트 만들기

「새 프로젝트 만들기」(「빈 폴더로 시작하거나, 채팅으로 요구를 말해 조립합니다」)를 누르면 펼쳐집니다.

1. 「이름」에 폴더 이름을 적습니다(예: my_app). 비어 있으면 「이름을 입력하세요」가 나오고, . · .. 와 \ / : * ? " < > | 는 쓸 수 없습니다. Windows 기준 금지 문자라, 다른 운영체제로 옮겨도 이름 때문에 열리지 않는 일을 줄여 줍니다. 다만 CON 같은 Windows 예약 이름은 검사하지 않습니다.
2. 「위치」에 폴더를 만들 상위 폴더를 둡니다. 기본은 홈 폴더 아래 Projects 이고(없으면 홈 폴더) 「변경…」으로 바꿉니다. 이미 있는 폴더여야 하며, 없거나 상대 경로이면 「위치 폴더를 찾을 수 없습니다」가 나옵니다. 앱이 위치 폴더를 몰래 만들지는 않습니다.
3. 「git 저장소로 초기화」는 처음부터 켜져 있습니다. 끄면 빈 폴더만 만듭니다.
4. 「만들고 열기」를 누르면 위치 안에 빈 폴더를 만들고(초기화를 켰다면 git init 까지) 목록에 추가해 엽니다. 같은 이름의 비어 있는 폴더가 이미 있으면 그대로 쓰고, 비어 있지 않으면 「이미 있는 폴더이고 비어 있지 않습니다」로 거절합니다.

「채팅으로 만들기」는 폴더를 만들지 않고 채팅 모드로 옮기기만 하는 단추입니다. 열려 있는 프로젝트가 없으면 채팅 화면이 다시 「프로젝트 추가」를 안내하니, 첫 폴더가 필요할 때는 「만들고 열기」나 「폴더 찾아보기」를 쓰세요.

프로젝트 전환과 닫기

• 사이드바 목록에서 다른 프로젝트를 고르면, 지금 열려 있는 프로젝트를 먼저 닫은 뒤 고른 프로젝트를 엽니다. 저장하지 않은 파일이나 살아 있는 터미널 세션(쉬고 있는 셸도 포함)이 있으면 먼저 어떻게 할지 묻고, 없으면 묻지 않고 넘어갑니다. 취소하면 지금 프로젝트에 그대로 머뭅니다.
• 이미 열려 있는 프로젝트를 다시 고르면 아무 일도 일어나지 않습니다.
• 전환해도 채팅 모드인지 코드 모드인지는 유지됩니다. 다만 「프로젝트 추가」로 더한 폴더는 코드 모드로 열립니다.
• 메뉴의 「워크스페이스 닫기」(Windows · Linux 에서는 «워크스페이스 닫기»)는 열린 프로젝트를 닫고 빈 화면으로 돌아갑니다. 프로젝트는 목록에 그대로 남습니다.

프로젝트가 열린 채로 앱을 끄면, 다시 켰을 때 마지막으로 연 폴더가 바로 열립니다. 「워크스페이스 닫기」로 닫았거나 열려 있던 프로젝트를 목록에서 제거했다면 빈 화면으로 뜨고, 그 폴더가 사라졌어도 빈 화면으로 뜹니다. 앱을 실행할 때 폴더 경로를 인자로 주면(예: Linux 에서 ./cocode <경로>) 마지막 폴더보다 그 폴더가 먼저 열립니다(폴더가 아니면 무시하고 마지막 폴더를 엽니다).

목록에서 제거

제거할 프로젝트 줄에 마우스를 올리거나 선택하면 나오는 휴지통 단추(「<이름> 목록에서 제거」)를 누르면 「프로젝트를 목록에서 제거할까요?」 확인창이 뜹니다. 창에는 프로젝트 이름과 경로, 「디스크의 폴더는 지우지 않습니다.」가 보이고, 열려 있는 프로젝트라면 「지금 열려 있는 프로젝트라 먼저 닫습니다.」도 함께 보입니다. 처음 초점은 「취소」에 있어서 Enter 키 한 번으로는 목록이 줄지 않고, 「목록에서 제거」를 눌러야 합니다.

열려 있는 프로젝트를 제거하면 먼저 닫습니다. 저장하지 않은 변경이 있어서 묻는 창에서 취소하면 목록도 그대로입니다.

사라진 폴더

폴더를 옮기거나 지우면 그 프로젝트는 목록에 그대로 남고, 앱을 다시 켤 때나 그 이름을 눌렀을 때 폴더가 없는 것을 확인해 사이드바에 「<이름> (찾을 수 없음)」으로 보입니다. 이름을 누르면 「폴더를 찾을 수 없습니다」 창이 뜨고 「옮겨졌거나 삭제된 것 같습니다. 목록에서 제거할까요?」를 묻습니다. 「목록에서 제거」를 누르면 뺍니다. 외장 디스크처럼 폴더가 돌아올 수 있다면 「닫기」를 눌러 목록에 남겨 두세요. 폴더가 돌아오면 다시 눌러서 열 수 있습니다.

대화와 상태 라벨

사이드바 「채팅·작업 · <프로젝트 이름>」 목록의 한 줄이 대화 하나입니다. 대화는 프로젝트에 속하고, 제목은 첫 요구입니다. 요구를 보내기 전의 빈 대화는 목록에 나오지 않습니다. 「새 작업」은 새 대화를 시작하지만 지금 대화가 비어 있으면 그 대화를 그대로 씁니다.

줄 오른쪽의 작은 글자가 대화의 상태 라벨입니다. 위에서부터 차례로 판정해 처음 맞는 것을 보입니다.

어느 것에도 해당하지 않으면 라벨이 붙지 않습니다. 순서가 있어서, 예를 들어 실패한 실행 뒤에 새 계획이 나오면 「실패」가 아니라 「확인 대기」로 보입니다.

앱을 다시 켜도 남는 것은 프로젝트 목록, 마지막으로 연 폴더, 설정(AI 공급자 · 모델 등), OS 키 저장소에 넣은 API 키, 탐색기에서 끌어 바꾼 항목 순서입니다. 설정이 저장되는 곳은 설정에 있습니다.

확인

• 프로젝트를 추가하면 사이드바 「프로젝트」 목록에 그 폴더 이름이 생기고 선택되어 있습니다.
• 「목록에서 제거」 뒤에도 파일 탐색기로 그 폴더를 열면 파일이 그대로 있습니다.

자주 겪는 문제