VS Code 확장

CollabOps VS Code 확장은 이슈, 변경요청 (CR), 프로젝트, 문서를 에디터 안에서 조회하고 관리하는 도구입니다. 브라우저를 오가지 않고 개발 흐름 안에서 작업을 처리할 수 있습니다.

VS Code 를 기반으로 하는 Cursor 에서도 동일하게 동작합니다.

1. 설치

마켓플레이스에서 설치

확장 페이지 주소는 marketplace.visualstudio.com/items?itemName=collabops.collabops 입니다.

VS Code 왼쪽 활동 표시줄에서 확장 아이콘을 선택합니다.

검색창에 CollabOps 를 입력합니다.

검색 결과에서 CollabOps 를 선택하고 설치를 누릅니다.

확장 뷰에서 CollabOps 를 검색한 결과 — 그림 1 — 확장 마켓플레이스 검색

설치가 끝나면 활동 표시줄에 CollabOps 아이콘이 나타납니다.

명령줄로 설치

code --install-extension collabops.collabops

Cursor 를 사용하는 경우:

cursor --install-extension collabops.collabops

설치 요구사항은 VS Code 1.90 이상입니다.

2. 로그인

로그인은 확장 안에서 직접 합니다. 별도의 사전 설정은 필요하지 않습니다.

VS Code 왼쪽 활동 표시줄에서 CollabOps 아이콘을 선택합니다.

로그인을 선택합니다.

서버 주소를 입력합니다.

이메일과 비밀번호를 입력합니다.

워크스페이스를 선택합니다.

입력 항목	설명
서버 주소	SaaS 는 기본값을 그대로 사용합니다. 온프레미스 환경에서는 해당 서버 주소를 입력합니다.
이메일	CollabOps 계정 이메일
비밀번호	CollabOps 계정 비밀번호
워크스페이스	접근 가능한 워크스페이스가 하나이면 자동으로 선택됩니다.

서버 주소, 이메일, 워크스페이스는 저장되므로 다음 로그인 시 다시 입력할 필요가 없습니다. 세션이 만료된 경우 비밀번호만 다시 입력하면 됩니다.

3. 화면 구성

활동 표시줄의 CollabOps 아이콘을 선택하면 사이드바에 다음 목록이 표시됩니다.

목록	내용
현황	내가 생성한 CR, 내 리뷰를 기다리는 CR, 나에게 할당된 이슈를 역할별로 묶어 표시합니다.
내 체인지 리퀘스트	본인이 작성한 CR
내 이슈	본인에게 할당된 이슈
워크스페이스 이슈	워크스페이스 전체 이슈
프로젝트	워크스페이스의 프로젝트
저장소	워크스페이스의 저장소
문서	워크스페이스의 문서
워크플로 실행	최근 파이프라인 실행 내역
라벨	워크스페이스 라벨
상태 그룹	이슈 상태 그룹 설정

항목의 상태는 아이콘으로 구분됩니다. 이슈는 진행 단계에 따라, 변경요청은 병합·종료·초안·충돌 여부에 따라 다르게 표시됩니다.

4. 조회

상세 보기

목록에서 항목을 선택하면 상세 내용이 마크다운으로 열립니다. 변경요청 상세에는 설명, 연결된 이슈, CI 실행 결과, 활동 이력이 함께 표시됩니다.

변경요청 상세 화면 — 그림 2-1 — 변경요청 상세. 설명, 연결된 이슈, 체크(CI) 결과, 활동이 한 화면에 나온다

브라우저에서 열려면 항목 오른쪽의 링크 아이콘을 선택합니다.

검색

이슈, 변경요청, 문서, 프로젝트, 저장소를 한 번에 검색합니다.

운영체제	단축키
macOS	Cmd + Alt + P
Windows · Linux	Ctrl + Alt + P

명령 팔레트에서 CollabOps: 검색 을 실행해도 동일합니다.

5. 편집

목록에서 항목을 우클릭하고 편집을 선택하면 편집 버퍼가 열립니다.

---
title: 로그인 화면 개선
status: in_progress
priority: high
end_date: 2026-08-20
---

본문을 마크다운으로 작성합니다.

- 목록
- 표
- 코드 블록

상단 영역에서 제목, 상태, 우선순위, 기한을 수정하고 아래 영역에서 본문을 작성합니다. 저장하면 변경된 항목만 반영됩니다.

6. 작업 처리

항목을 우클릭하면 대상에 맞는 작업이 표시됩니다.

대상	지원 작업
이슈	생성, 닫기, 다시 열기, 코멘트, 이슈 링크, 서브이슈, 문서 연결
변경요청	생성, 리뷰, 병합, 초안 전환, 코멘트, 이슈 연결, 문서 연결
문서	생성, 본문 편집, 버전 복원, 코멘트
프로젝트	생성, 멤버·팀·마일스톤 관리
워크플로 실행	취소, 재실행, 로그 확인

데이터를 변경하는 작업은 입력 또는 확인 절차를 거칩니다.

7. Git 연동

에디터에서 다음 작업을 실행할 수 있습니다.

이슈에서 토픽 브랜치 생성

변경요청의 소스 브랜치 체크아웃

변경요청의 변경 사항 비교

변경요청 브랜치를 대상 브랜치로 갱신

저장소 클론

Git 명령은 통합 터미널로 전달됩니다. 작업 트리를 변경하는 명령은 터미널에 입력만 되며 실행 여부는 사용자가 결정합니다.

8. 주요 명령

명령 팔레트에서 CollabOps 를 입력하면 사용 가능한 명령이 표시됩니다.

명령	설명
CollabOps: 로그인	서버 연결 및 인증
CollabOps: 로그아웃	저장된 세션 삭제
CollabOps: 워크스페이스 선택	워크스페이스 전환
CollabOps: 서버 변경	서버 주소 변경 후 재로그인
CollabOps: 검색	통합 검색
CollabOps: 새로 고침	모든 목록 갱신

9. 참고 사항

본문 편집 시 공백 처리

서버가 저장 과정에서 텍스트 앞뒤 공백을 제거하므로 강조, 코드, 링크 서식에 인접한 공백이 사라질 수 있습니다. 웹 편집기에도 동일하게 적용되는 동작입니다.

이미지

본문에 포함된 이미지는 식별자로 표시되며 에디터에서 미리보기가 지원되지 않습니다. 편집 후 저장해도 첨부는 유지됩니다.

지원하지 않는 기능

영구 삭제 — 웹에서 처리합니다.

담당자 및 라벨 지정

원격 개발 환경

Remote SSH 또는 Dev Container 환경에서는 확장이 원격에서 실행되므로 해당 환경에서 별도로 로그인해야 합니다.

10. 문제 해결

증상	확인 사항
목록에 오류가 표시됨	세션 만료일 가능성이 높습니다. CollabOps: 로그인 을 다시 실행합니다.
온프레미스 환경에서 연결되지 않음	서버 주소를 확인합니다. 사설 인증서를 사용하는 경우 VS Code 의 http.systemCertificates 설정을 확인합니다.
목록이 비어 있음	워크스페이스가 올바르게 선택되었는지 확인합니다. CollabOps: 워크스페이스 선택 으로 전환할 수 있습니다.

VS Code 확장

목차