Linear
Linear에서 이슈를 Cursor에 할당하거나 댓글에서 @Cursor를 언급해 클라우드 에이전트를 바로 사용하세요.
시작하기
설치
Linear 통합을 연결하려면 Cursor 관리자여야 합니다. 그 외 팀 설정은 관리자가 아닌 멤버도 이용할 수 있습니다.
- Cursor 통합으로 이동합니다
- Linear 옆의 _연결_을 클릭합니다
- Linear 워크스페이스를 연결하고 팀을 선택합니다
- _승인_을 클릭합니다
- Cursor에서 남은 Cloud Agent 설정을 완료합니다:
- 저장소 공급자를 연결하고 기본 저장소를 선택합니다
- 사용량 기반 요금제를 활성화합니다
- 프라이버시 설정을 확인합니다
계정 연결
처음 사용할 때 Cursor와 Linear 계정 연결을 안내합니다. PR을 생성하려면 저장소 공급자 연결이 필요합니다.
사용 방법
이슈를 Cursor에 위임하거나 댓글에서 @Cursor를 언급하세요. Cursor가 이슈를 분석해 개발 작업이 아닌 항목을 자동으로 걸러냅니다.
이슈를 Cursor에 할당하기
- Linear 이슈 열기
- 담당자 필드 클릭
- "Cursor" 선택
Cursor 언급하기
댓글에서 @Cursor를 언급해 새 에이전트를 할당하거나 추가 지시를 제공할 수 있습니다. 예: @Cursor fix the authentication bug described above
워크플로
클라우드 에이전트는 Linear에 실시간 상태를 표시하고 작업이 완료되면 자동으로 PR을 생성합니다. Cursor 대시보드에서 진행 상황을 확인하세요.
후속 지시
에이전트 세션에서 응답하면 에이전트에 후속 지시로 전달됩니다. 실행 중인 Cloud Agent에 추가 안내를 제공하려면 Linear 댓글에서 @Cursor를 언급하세요.
구성
Dashboard → 클라우드 에이전트에서 Cloud Agent 설정을 구성합니다.
| 설정 | 위치 | 설명 |
|---|---|---|
| 기본 저장소 | Cursor 대시보드 | 프로젝트 저장소가 설정되지 않은 경우 사용할 기본 저장소 |
| 기본 모델 | Cursor 대시보드 | 클라우드 에이전트용 AI 모델 |
| 기준 브랜치 | Cursor 대시보드 | PR 생성의 기준이 되는 브랜치(일반적으로 main 또는 develop) |
구성 옵션
여러 방법으로 Cloud Agent의 동작을 구성할 수 있습니다:
이슈 설명 또는 댓글: [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 모델 지정
저장소 선택
Cursor는 다음 우선순위에 따라 작업할 저장소를 결정합니다.
- 이슈 설명/댓글: 이슈 본문 또는 댓글의
[repo=owner/repository]구문 - 이슈 라벨: 해당 Linear 이슈에 연결된 저장소 라벨
- 프로젝트 라벨: Linear 프로젝트에 연결된 저장소 라벨
- 기본 저장소: Cursor 대시보드 설정에서 지정한 저장소
저장소 라벨 설정
Linear에서 저장소 라벨을 생성하려면 다음 단계를 따르세요.
- Linear 워크스페이스에서 설정으로 이동합니다
- 라벨을 클릭합니다
- 새 그룹을 클릭합니다
- 그룹 이름을 "repo"로 지정합니다(대소문자는 구분하지 않지만, 반드시 정확히 "repo"여야 하며 "Repository" 등 다른 표기는 사용할 수 없습니다)
- 해당 그룹에서 각 저장소에 대해
owner/repo형식의 라벨을 생성합니다
이 라벨을 이슈나 프로젝트에 할당하여 Cloud Agent가 작업할 저장소를 지정할 수 있습니다.
고급 기능
트리아지 규칙(고급)
Linear에서 자동화 규칙을 설정하여 이슈를 Cursor에 자동으로 위임하세요.
- Linear 프로젝트 설정으로 이동합니다
- 트리아지 규칙으로 이동합니다
- 다음 작업을 자동으로 수행하는 규칙을 만듭니다.
- 특정 라벨 추가
- 이슈를 Cursor에 할당
- 조건에 따라 클라우드 에이전트 트리거
트리아지 규칙은 현재 일부 제한 사항이 있는 고급 기능입니다. 규칙이 실행되려면 Linear에서 담당자로 사람을 지정해야 하지만, 이 요구 사항은 향후 업데이트에서 없어질 수 있습니다.
도움 받기
지원팀에 문의할 때 에이전트 활동을 확인하고 요청 ID를 함께 보내세요.
피드백
Linear 댓글이나 Cursor 대시보드의 지원 채널을 통해 피드백을 보내주세요.