Get Started
- Cursor는 VS Code 위에서 만들어진 툴이므로, VS Code 사용자들은 그 세팅을 언제든 옮겨올 수 있다
- 질문 : 어떻게?
- 대답 : Cmd + Shift + P 누르고 import vs code setting 치면 됨
Tab (코드 자동완성 기능)
- 커서가 위치한 자리 뒤에 무조건 코드를 덧붙이는 방식(=GitHub Copilot 방식)이 아니라, 커서 주변의 코드에 대한 추가/수정/삭제를 제안
- Copilot과 Cursor Tab 중 하나만 사용하는 것을 추천
- 커서가 위치한 자리 한줄 위부터, 커서 아래 두줄까지, 코드를 동시에 수정
- 동시에 여러가지 수정 사항을 제안
- 최근 코드 수정 사항을 반영해 제안
- 작성하고 있는 언어가 아니라, 자연어로 코드 상에 해야 할 일을 적으면 코드로 치환해줌 (Instruction-based edits)
- 자동 완성은 코드 에디터 상에서 뿐 아니라 Peek view에서도 가능 (에디터 상에 뜨는, editor-in-editor)
- VS Code를 vim 모드에서 사용한다면, 어떤 함수 정의 위에서
gd를 눌렀을 때, peek view가 활성화되는데, peek view에서는 오른쪽 옆에 해당 함수가 사용된 모든 용례가 나열되게 되므로, peek 뷰에서 함수의 정의를 수정한 뒤에, 해당 함수를 참조하고 있는 파일을 선택하고 tab을 연타해가면서 함수의 용례를 모두 바꿀 수 있다- 부정확한 search and replace 안해도 됨
- 질문 : 함수 이름 위에서 gd 눌러서 Peek 뷰를 연 뒤에, 해당 함수를 참조하는 파일들을 차례로 navigate 할 수 있는 단축키는?
- 답변 : F4 (다음), Shift + F4 (이전)
- VS Code를 vim 모드에서 사용한다면, 어떤 함수 정의 위에서
- Tab을 눌러서 자동 완성이 다 끝나면, Cursor는 다음으로 이동해야 할 위치에 대한 제안도 자동 완성으로 해준다. 커서 이동에 대한 제안을 받아들이는 것도 역시 Tab.
Chat
- 채팅을 해서 질의응답을 할 수 있다
- 채팅 히스토리를 보고, 필요한 경우 지울 수 있다 (Cmd Option L)
- 파일 에디터에서 채팅을 열면, 해당 파일이 기본 컨텍스트가 된다
- Option Enter 누르면 현재 파일을 컨텍스트로 넘기지 않는다
- @ 멘션을 통해 다른 컨텍스트를 추가할 수 있다 (아래 Context 항목 참고)
- 에디터에서, 에러가 난 부분 위에서 Cmd Shift E 누르면, 채팅으로 해당 에러에 대한 의견을 바로 내어 준다.
- Long Context Chat (Beta)
- Long Context Chat 켜면, Long Context Chat을 지원하는 LLM 모델들을 사용하게 되고, 해당 모델들은 더 큰 컨텍스트 윈도우를 가지고 있기 때문에 전체 폴더를 컨텍스트로 포함할 수 있음
- 채팅 모델 변경 = Cmd + /
- 코드베이스 기반으로 한 탐색과 응답(Embeddings Search)을 위해서는 Cmd + Enter를 누른다. 좀 더 정확도를 높이려면 @Codebase를 사용해 여러 옵션들을 선택해야 한다.
Cmd + K (코드 내 자연어 명령 기능)
- 코드 상에서 Cmd (Control) + K 누르면 프롬프트 바가 열림. 거기다가 Cursor에게 요청을 날리면 됨
- @ 을 통해 파일이나 다른 컨텍스트를 멘션할 수 있음
- 코드의 일부 텍스트를 선택한 상태에서나, 선택하지 않은 상태에서 수행할 수 있음
- 프롬프트에 할일이나, 할 일에 대한 질문을 넣고 Option (Alt) + Enter 누르면 해당 요청에 대해 이런 저런 의견을 줌
- 결과가 나온 상태에서 accept 하기 전에 추가 요청사항을 재전달할 수 있음
- (Default Context에 관한 언급이 있었는데 이해하지 못함; 뒤에 이어서 Context 단원이 있으므로 넘어감)
- 터미널에서도 자연어 명령이 됨!
-
Cursor 내의 터미널에서도 Cmd + K를 사용해서 자연어 명령을 내리면, 터미널 명령어도 알아서 만들어 줌
-
Context (응답을 위한 배경 지식, 선후 관계 등)
- Codebase Indexing
- Cursor는 어쨌든 좀 더 좋은 올바른 대답을 주기 위해서, 계속 내 codebase를 indexing 해두고 있음. 변경 사항이 생길 때마다 자동으로 계속 인덱싱을 함.
- 기본적으로 코드베이스 내의 모든 파일을 인덱싱함.
- .gitignore 내의 파일들은 기본적으로 인덱싱되지 않음.
- 일부 거대한 파일을 인덱싱하는 것이 불필요한 경우 수동으로 제외시킬 수 있음.
- 추가적으로 제외할 항목들은 .cursorignore 파일에 등록해두면 됨
- 질문 : 흔히 인덱싱하지 않아도 될 파일들의 예시가 무엇인지?
- 대답 : dist/, *log, config.json 등
- Rules for AI
- Chat이나 Cmd + K에서 AI가 참고해야 할 custom instructions.
- .cursorrules 파일로 외부에 정의해둬도 됨
- 질문 : 일반적으로, 더 나은 응답을 위해서 어떤 룰들을 추가해두는 게 좋을지?
- @ 으로 Chat이나 Cmd + K에서 사용될 Context를 제공할 수 있다
- @File
- 너무 긴 경우, Cursor는 파일을 잘라서 필요한 부분만 reference 한다
- @Folder
- Long Context Chat을 사용하면 폴더를 통째로 넣고 맥락으로 사용하게끔 할 수 있다
- @Code (함수, 변수, 타입 정의 등)
- 코드 에디터에서 질문하거나 수정할 대상을 선택한 상태로, Cmd Shift L 하면 채팅에 해당 부분이 언급되고, Cmd Shift K 하면 프롬프트에 해당 부분이 언급된 채로 대화가 시작됨
- @Docs
- 이미 등록되어 있는 공식문서를 기반으로 대답해달라고 할 수 있음
- 공식문서를 추가할 수 있음
- @Git
- 커밋 등을 언급할 수 있다
- 커밋을 언급하면서 해당 커밋이 야기할 버그나 이슈에 대해서 질문할 수 있다
- @Diff of Working State
- 아직 커밋되지 않은 변경사항을 언급할 수 있다
- 커밋 메시지 써달라고도 할 수 있음..!
- @Web
- 질문에 대한 답을 웹 검색을 통해서 해준다
- @Chat
- 나누고 있던 챗 메시지를 언급하기 위해서, Cmd + K에서 사용함
- @Definitions
- Cmd + K에서, 코드 가까이에 있는 definition 들을 참조하기 위해 사용함
- 기존 함수 정의와 동일한 패턴으로 짜줘, 같은 명령을 내릴 수 있다
- @URL 링크
- 특정 url을 언급하면서, 참조하게 시킬 수 있다
- 특히, 요약을 시킬 수 있다!
- @File
Advanced
- AI Review (Beta)
- 베타 세팅에 가서 켜야 함
- 최근에 작성된 코드들에 대해서 potential 버그가 없는지 등에 대해 리뷰를 해달라고 부탁하는 기능
- Shadow Workspace
- 백그라운드에서 AI가 돌면서 코드 생성/보완을 해줌
- 현재는 코드에 lint 작업을 반복해주는 정도라고 함
- 질문 : 어느 정도로 유용할까?