Linear
Linear에서 Background Agents와 작업하기
이슈를 Cursor에 위임하거나 댓글에서
@Cursor를 멘션해서 Linear에서 바로 Background Agents를 써.
시작하기
설치
Linear 통합을 연결하려면 Cursor 관리자여야 해. 다른 팀 설정은 관리자 권한이 없는 멤버도 사용할 수 있어.
- Cursor integrations로 이동
- Linear 옆의 Connect 클릭
- 네 Linear 워크스페이스를 연결하고 팀 선택
- Authorize 클릭
- Cursor에서 남은 Background Agent 설정 완료:
- GitHub 연결 및 기본 리포지토리 선택
- 사용량 기반 결제 활성화
- 개인정보 보호 설정 확인
계정 연결
처음 사용할 때 Cursor와 Linear 계정을 연결하라고 안내될 거야. PR 생성을 하려면 GitHub 연결이 필요해.사용 방법
이슈를 Cursor에 위임하거나 댓글에서@Cursor를 언급해. Cursor가 이슈를 분석하고 비개발 작업은 자동으로 걸러줘.
이슈 위임하기
- Linear 이슈 열기
- 담당자 필드 클릭
- “Cursor” 선택
Cursor 언급하기
새 에이전트를 배정하거나 추가 지침을 주려면 댓글에@Cursor를 언급해. 예: @Cursor 위에 설명한 인증 버그를 수정해줘.
워크플로우
Background Agents는 Linear에서 실시간 상태를 표시하고, 완료되면 자동으로 PR을 만들어. 진행 상황은 Cursor 대시보드에서 확인할 수 있어.후속 지시
에이전트 세션에 답장하면 에이전트에게 후속 지시로 전달돼. 실행 중인 Background Agent에 추가 지시를 하려면 Linear 댓글에서@Cursor를 멘션하면 돼.
Configuration
Dashboard → Background Agents에서 Background Agent 설정을 구성해.| Setting | Location | Description |
|---|---|---|
| Default Repository | Cursor Dashboard | 프로젝트 저장소가 설정되지 않았을 때 기본으로 사용할 주 저장소 |
| Default Model | Cursor Dashboard | Background Agents에 사용할 AI 모델 |
| Base Branch | Cursor Dashboard | PR을 만들 기준 브랜치(보통 main 또는 develop) |
Configuration options
여러 가지 방법으로 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]
repo: 대상 저장소 지정(예:owner/repository)branch: PR 생성 시 기준 브랜치 지정model: 사용할 AI 모델 지정
Repository selection
Cursor는 다음 우선순위로 작업할 저장소를 결정해:- Issue description/comments: 이슈 본문이나 댓글의
[repo=owner/repository]문법 - Issue labels: 해당 Linear 이슈에 붙은 저장소 라벨
- Project labels: Linear 프로젝트에 붙은 저장소 라벨
- Default repository: Cursor 대시보드 설정의 기본 저장소
Setting up repository labels
Linear에서 저장소 라벨을 만들려면:- Linear 워크스페이스의 Settings로 이동
- Labels 클릭
- New group 클릭
- 그룹 이름을 “repo”로 지정해(대소문자 무관 — 반드시 정확히 “repo”여야 하고 “Repository” 같은 변형은 안 돼)
- 그 그룹 안에 각 저장소에 대해
owner/repo형식의 라벨을 만들어