GitHub Actions 및 기타 CI/CD 시스템에서 Cursor CLI를 사용해 개발 작업을 자동화하자.
기본 구성:
- name: Cursor CLI 설치
run: |
curl https://cursor.com/install -fsS | bash
echo "$HOME/.cursor/bin" >> $GITHUB_PATH
- name: Cursor Agent 실행
env:
CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
run: |
cursor-agent -p "여기에 프롬프트를 입력해" --model gpt-5
실무 워크플로에 도움이 되는 쿠크북 예시를 확인해봐: 문서 업데이트와 CI 문제 해결.
다음이 갖춰진 어떤 CI/CD 시스템에서도 Cursor CLI를 사용할 수 있어:
- 셸 스크립트 실행(bash, zsh 등)
- API 키 구성을 위한 환경 변수
- Cursor API에 접근할 인터넷 연결
에이전트의 자율성 수준을 선택해:
에이전트가 git 작업, API 호출, 외부 상호작용을 모두 직접 제어하게 해. 설정은 더 간단하지만, 더 큰 신뢰가 필요해.
예시: 우리 Update Documentation 쿠크북의 첫 번째 워크플로우에선 에이전트가 다음을 수행해:
- PR 변경 사항 분석
- git 브랜치 생성 및 관리
- 변경 사항 커밋 및 푸시
- 풀 리퀘스트에 댓글 작성
- 모든 오류 시나리오 처리
- name: 문서 업데이트 (완전 자율)
run: |
cursor-agent -p "git, GitHub CLI, 그리고 PR 작업에 완전한 접근 권한이 있어.
커밋, 푸시, 그리고 PR 댓글을 포함해 전체 문서 업데이트 워크플로우를 처리해."
프로덕션 CI 워크플로에선 권한 기반 제한과 함께 이 접근 방식을 쓰는 걸 추천해. 이렇게 하면 두 가지 장점을 모두 챙길 수 있어: 에이전트가 복잡한 분석과 파일 수정을 똑똑하게 처리하면서도, 중요한 작업은 결정론적이고 감사 가능하게 유지돼.
중요 단계를 별도의 워크플로 단계로 분리하면서 에이전트의 작업 범위를 제한해. 제어와 예측 가능성이 더 좋아져.
예시: 같은 쿠크북의 두 번째 워크플로는 에이전트를 파일 수정으로만 제한해:
- name: 문서 업데이트 생성 (제한됨)
run: |
cursor-agent -p "중요: 브랜치 생성, 커밋, 푸시, PR 댓글 작성 금지.
작업 디렉터리의 파일만 수정해. 게시 작업은 이후 워크플로 단계에서 처리돼."
- name: 문서 브랜치 게시 (결정적)
run: |
# CI에서 결정적 git 작업을 처리함
git checkout -B "docs/${{ github.head_ref }}"
git add -A
git commit -m "docs: PR 업데이트"
git push origin "docs/${{ github.head_ref }}"
- name: PR 댓글 게시 (결정적)
run: |
# CI에서 결정적 PR 댓글 작성을 처리함
gh pr comment ${{ github.event.pull_request.number }} --body "문서가 업데이트됨"
CLI 수준에서 제한을 적용하려면 권한 구성을 사용해.
{
"permissions": {
"allow": [
"Read(**/*.md)",
"Write(docs/**/*)",
"Shell(grep)",
"Shell(find)"
],
"deny": [
"Shell(git)",
"Shell(gh)",
"Write(.env*)",
"Write(package.json)"
]
}
}
먼저 Cursor 대시보드에서 API 키를 생성해.
리포지토리에 Cursor API 키를 안전하게 저장해:
- GitHub 리포지토리로 이동해
- Settings → Secrets and variables → Actions를 클릭해
- New repository secret을 클릭해
- 이름을
CURSOR_API_KEY로 지정해
- 값으로 API 키를 붙여 넣어
- Add secret을 클릭해
CURSOR_API_KEY 환경 변수를 설정해:
env:
CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}