파일·터미널·Git
파일을 찾아 대화에 연결하고 터미널에서 실행한 뒤, 변경 범위를 비교하고 커밋·푸시합니다.
대화가 끝나면 실제 파일과 실행 결과를 확인합니다. Liverary의 파일 탐색, 터미널과 Git 작업은 현재 대화가 연결된 실행 환경과 작업 폴더를 사용합니다. 이 문서는 공개 설치본 1.0.0을 기준으로 합니다.
파일 찾고 대화에 연결하기
파일 탐색 화면에서 폴더를 펼치거나 파일 검색에 파일명·경로를 입력합니다. 파일 안의 문장을 찾으려면 프로젝트 내용 검색을 사용하세요. 파일명 검색과 본문 검색을 나누어 쓰면 대상이 분명해집니다.
- 관련 파일을 찾아 열고 내용을 확인합니다.
- 파일 메뉴의 대화에 추가를 선택해 입력창에 파일 참조를 넣습니다. 멘션 복사로 참조를 복사할 수도 있습니다.
- 파일에 대해 원하는 행동을 덧붙여 보냅니다.
예를 들어 로그인 컴포넌트를 추가한 뒤 “이 파일에서 버튼 크기를 결정하는 부분을 설명해 줘”라고 요청할 수 있습니다. 파일을 열기만 한 것과 대화에 참조를 추가한 것은 구분하세요. 어떤 파일을 기준으로 질문하는지 입력창에서 확인하면 됩니다.
검색 결과가 없다면 폴더·워크트리가 맞는지, 경로를 너무 좁게 입력하지 않았는지 확인합니다. 결과가 많아 일부만 보인다는 안내가 나오면 파일명이나 하위 폴더를 더 구체적으로 입력하세요.
텍스트 직접 수정하기
편집 가능한 프로젝트 텍스트 파일은 파일 화면에서 직접 수정할 수 있으며, 변경은 자동 저장됩니다. 파일을 열 수 있다고 항상 편집할 수 있는 것은 아닙니다. 바이너리·미디어의 미리보기, 크기 제한이 있는 파일, 읽기 전용 연결에서는 제공되는 기능이 다릅니다.
저장 오류나 읽기 전용 연결 안내가 있으면 수정한 내용이 디스크에 반영되었다고 판단하지 마세요. 연결과 파일 쓰기 권한을 확인하고 저장 상태를 확인한 뒤 다음 작업을 진행합니다. 에이전트와 사람이 같은 파일을 수정했다면 최종 내용은 변경 비교에서 함께 검토하세요.
터미널로 실행 결과 확인하기
대화에서 터미널 열기를 누르면 선택한 환경의 실제 셸을 사용합니다. Windows 로컬 프로젝트와 WSL 프로젝트는 실행 위치와 명령 환경이 다릅니다. 새 워크트리를 선택한 대화라면 원본 폴더가 아닌 그 작업 폴더인지도 확인하세요.
- 터미널의 현재 경로를 확인합니다. PowerShell에서는
Get-Location, Linux 셸에서는pwd를 사용할 수 있습니다. - 프로젝트 README에 적힌 설치·개발·검사 명령을 실행합니다. 프로젝트마다 명령이 다르므로 무조건 같은 빌드 명령을 쓰지 않습니다.
- 실패했다면 명령과 오류 부분을 선택하고 대화에 추가를 사용해 원인 분석을 요청합니다.
새 터미널이나 터미널 분할을 이용하면 개발 서버를 실행해 둔 채 다른 터미널에서 검사를 실행할 수 있습니다. 실행 중인 터미널을 닫을 때는 종료 확인을 읽고, 계속 필요한 서버나 작업인지 확인하세요.
변경 범위 선택해서 비교하기
변경 내용을 열어 파일별 추가·삭제 내용을 확인합니다. 같은 파일이라도 비교 범위에 따라 보이는 내용이 달라집니다.
| 범위 | 확인할 내용 |
|---|---|
| 커밋하지 않음 | 현재 작업 폴더에 남은 미커밋 변경을 확인합니다. 직접 수정한 내용도 포함될 수 있습니다. |
| 최근 작업 또는 개별 작업 | 완료된 에이전트 작업의 체크포인트 사이에서 무엇이 달라졌는지 확인합니다. |
| 커밋 | 선택한 Git 커밋의 변경을 확인합니다. |
작업별 비교는 Git 저장소와 완료된 작업의 체크포인트가 있어야 합니다. Git이 아닌 폴더나 아직 끝나지 않은 작업에서 같은 결과가 나오리라고 기대하지 마세요. 화면이 갱신되지 않았다면 변경 내용 새로고침을 사용하고, 대상 브랜치와 비교 범위도 다시 확인합니다.
커밋하고 원격에 올리기
검토할 때는 요청한 파일 외에 예상하지 않은 파일이 바뀌지 않았는지 확인하고, 프로젝트에 있는 관련 검사까지 마칩니다. 이후 Git 작업에서 커밋을 진행합니다.
- 현재 브랜치와 변경 파일을 확인합니다.
- 변경사항 커밋 창에서 파일 목록 옆 편집을 눌러 포함할 파일을 선택합니다.
- 커밋 메시지를 입력하거나, 자동 생성을 원하면 비워 둔 뒤 커밋합니다.
- 원격 저장소에 반영하려면 별도로 푸시를 실행하고 성공 상태를 확인합니다.
새 대화에서 아직 작업이나 변경이 없다면 커밋·변경 메뉴가 보이지 않을 수 있습니다. 푸시가 비활성화되면 메뉴의 사유를 확인하세요. 선택한 브랜치가 없거나, origin이 없거나, 원격보다 뒤처져 있거나, 올릴 로컬 커밋이 없는 경우 등에는 먼저 해당 상태를 정리해야 합니다. 원격 쓰기에는 해당 실행 환경의 Git 인증이 필요합니다.
체크포인트는 대화를 되돌리기 위한 별도의 Git 기록입니다. 체크포인트가 생겼다고 사용자 브랜치에 커밋되거나 원격에 푸시되는 것은 아닙니다. 파일까지 복원하려면 대화 되돌리기의 두 선택지를 확인하세요. Git이 아닌 폴더에서 버전 관리를 시작하려는 경우에만 제공되는 Git 초기화를 사용합니다.