메인 콘텐츠로 건너뛰기
이슈를 Cursor에 위임하거나 댓글에서 @Cursor를 멘션해서 Linear에서 바로 Background Agents를 사용해.

시작하기

설치

Linear 통합을 연결하려면 Cursor 관리자여야 해. 다른 팀 설정은 비관리자 멤버도 사용할 수 있어.
  1. Cursor integrations로 이동
  2. Linear 옆의 Connect 클릭
  3. Linear 워크스페이스를 연결하고 팀 선택
  4. Authorize 클릭
  5. Cursor에서 남은 Background Agent 설정 마무리:
    • GitHub 연결하고 기본 리포지토리 선택
    • 사용량 기반 과금 켜기
    • 개인정보 설정 확인

계정 연결

처음 사용할 때 Cursor랑 Linear 계정을 연결해야 해. PR 만들려면 GitHub 연결이 필요해.

사용 방법

이슈를 Cursor에 맡기거나 댓글에 @Cursor를 멘션해. Cursor가 이슈를 분석해서 비개발 업무는 자동으로 걸러줘.

이슈 위임하기

  1. Linear 이슈 열기
  2. 담당자 필드 클릭
  3. “Cursor” 선택
Linear에서 Cursor에 이슈를 위임하기

Cursor 멘션하기

새 에이전트를 배정하거나 추가 지침을 알려주려면 댓글에 @Cursor를 멘션해. 예: @Cursor 위에 설명한 인증 버그를 고쳐줘.

워크플로우

Background Agents는 Linear에서 실시간 상태를 표시하고 완료되면 자동으로 PR을 만들어. 진행 상황은 Cursor 대시보드에서 확인할 수 있어.
Linear의 Background Agent 상태 업데이트

후속 안내

에이전트 세션에서 답장하면 에이전트에 대한 후속 메시지로 전송돼. 실행 중인 Background Agent에 추가 지침을 주려면 Linear 댓글에서 @Cursor를 멘션하면 돼.

구성

Dashboard → Background Agents에서 Background Agent 설정을 관리해.
SettingLocationDescription
Default RepositoryCursor Dashboard프로젝트 리포지토리가 지정되지 않았을 때 사용할 기본 리포지토리
Default ModelCursor DashboardBackground Agents에 사용할 AI 모델
Base BranchCursor DashboardPR을 생성할 기준 브랜치(보통 main 또는 develop)

구성 옵션

Background Agent 동작은 여러 방법으로 설정할 수 있어: Issue description or comments: [key=value] 문법을 써. 예:
  • @cursor please fix [repo=anysphere/everysphere]
  • @cursor implement feature [model=claude-3.5-sonnet] [branch=feature-branch]
Issue labels: 상위-하위 레이블 구조를 사용해. 상위 레이블은 구성 키, 하위 레이블은 값이야. Project labels: 이슈 레이블과 동일한 상위-하위 구조를 프로젝트 레벨에 적용해. 지원되는 구성 키:
  • repo: 대상 리포지토리 지정(예: owner/repository)
  • branch: PR 생성 시 기준 브랜치 지정
  • model: 사용할 AI 모델 지정

리포지토리 선택

Cursor는 다음 우선순위로 작업할 리포지토리를 결정해:
  1. Issue description/comments: 이슈 본문이나 코멘트의 [repo=owner/repository] 문법
  2. Issue labels: 해당 Linear 이슈에 연결된 리포지토리 레이블
  3. Project labels: Linear 프로젝트에 연결된 리포지토리 레이블
  4. Default repository: Cursor 대시보드 설정에 지정된 리포지토리

리포지토리 레이블 설정

Linear에서 리포지토리 레이블을 만들려면:
  1. Linear 워크스페이스의 Settings로 이동
  2. Labels 클릭
  3. New group 클릭
  4. 그룹 이름을 “repo”로 지정(대소문자 무시 - 반드시 정확히 “repo”여야 하고 “Repository” 등 변형은 불가)
  5. 해당 그룹 안에 owner/repo 형식으로 각 리포지토리 레이블 생성
이 레이블을 이슈나 프로젝트에 할당해서 Background Agent가 작업할 리포지토리를 지정할 수 있어.
Linear에서 리포지토리 레이블 구성하기
I