Linear에서 Background Agents를 바로 쓰려면 이슈를 Cursor에 할당하거나 댓글에 @Cursor를 멘션해.

​
시작하기

​
설치

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에서 리포지토리 라벨 구성하기