CollabOps

co CLI

터미널에서 CollabOps 를 다루는 커맨드라인 도구

co 는 변경요청 (CR)·이슈·프로젝트·워크스페이스를 터미널에서 다루는 CLI 입니다. 평소 쓰던 IDE 에서 벗어나지 않고 CollabOps 를 쓸 수 있고, AI agent 에서도 그대로 호출할 수 있습니다.

이 섹션은 명령 단위 레퍼런스 입니다. 처음 써본다면 먼저 빠른 시작을 보세요.

→ 빠른 시작 (5분) — 설치, 로그인, 첫 CR 까지

설치

curl 과 python3 만 있으면 됩니다 (대부분의 macOS / Linux 에 이미 설치되어 있음). 한 줄로 설치합니다:

curl -fsSL https://docs.collabops.ai/install.sh | bash

현재 머신의 OS/CPU 를 자동 감지해서 ~/.local/bin/co 에 Go 단일 바이너리 (~9MB) 를 떨어뜨립니다. 업데이트는 co update 또는 같은 명령 재실행. PATH 에 ~/.local/bin 이 없으면 스크립트가 안내해 줍니다. 지원 플랫폼: darwin/amd64, darwin/arm64, linux/amd64, linux/arm64.

수동으로 설치하려면 한 파일만 받아 실행 권한을 주면 됩니다:

curl -fsSL https://docs.collabops.ai/install/co -o ~/.local/bin/co && chmod +x ~/.local/bin/co

로그인

co auth login

API URL, 이메일, 비밀번호, 기본 워크스페이스 슬러그를 차례로 묻습니다. 자세한 옵션은 auth 페이지를 보세요.

명령 그룹

각 그룹의 페이지에 모든 옵션·동작·예제가 정리되어 있습니다.

명령용도
co auth로그인 / 로그아웃 / 인증 상태 확인
co status (별칭: co me)내 CR·이슈를 역할별로 모아보기
co cr (별칭: co pr)변경요청 — 생성·조회·리뷰·머지, 이슈/문서 연결
co issue이슈 — CRUD, 하위 이슈 트리, 작업 브랜치 만들기
co label워크스페이스 라벨 관리
co status-group이슈 상태 그룹 관리
co project프로젝트 — CRUD, 멤버·팀, 마일스톤
co docs문서 — 조회, 생성, 수정, 댓글, 버전, export
co repo저장소 — clone, 목록·상세, 생성·수정·삭제
co runCI/CD 실행 — 목록, 상세, 로그, 취소, 재실행
co browse지금 보고 있는 것을 웹에서 열기 (또는 URL 만 출력)
co workspace (별칭: co ws)내가 속한 워크스페이스 목록
co config설정 읽기/쓰기, 환경 프로필 전환
co alias자주 쓰는 명령을 짧은 이름으로 묶기
co update최신 버전으로 자체 업데이트

출력 형식

목록은 표로, 상세는 항목별로 출력됩니다. 날짜만 있는 값은 2026-08-13 처럼, 시각까지 있는 값은 2026-08-13 14:53 KST 처럼 어느 명령에서나 같은 모양으로 나옵니다.

co config set display.timezone UTC   # 출력되는 시각을 UTC 로 고정
co config unset display.timezone     # 다시 이 컴퓨터의 시간대로

시간대를 지정하지 않으면 이 컴퓨터의 시간대를 씁니다. 목록 명령은 표 아래위에 몇 건 중 몇 건을 보여주는지 함께 알려주고, -l 0 을 주면 페이지를 끝까지 따라가 전부 가져옵니다.

자동화·CI 에서 쓰기

AI agent 가 CR 을 생성하면 제목 앞에 🤖 [BETA] 접두어가 붙고, 본문 끝에 어떤 agent / model 이 만들었는지 표기되는 푸터가 추가됩니다. CLAUDECODE=1 또는 CO_AS_BOT=1 환경 변수가 있으면 자동 적용되고, --bot 플래그로도 강제할 수 있습니다.

디버그가 필요하면 CO_DEBUG=1 co cr list 처럼 환경 변수 한 개만 붙이면 stderr 로 모든 HTTP 요청·응답이 찍힙니다.

도움말

co --help          # 전체 명령
co cr --help       # 하위 명령
co config path     # 설정 파일 경로 출력

설정 파일은 ~/.config/collabops/config.json 에 저장됩니다 (mode 0600).

목차

설치로그인명령 그룹출력 형식자동화·CI 에서 쓰기도움말