co doctor — 환경 점검
git · SSH · 로그인 점검과 git 설치
co doctor 는 이 컴퓨터가 CollabOps 저장소를 다룰 준비가 되었는지 점검합니다. git 이 없으면 OS 에 맞는 설치 명령을 보여주고, 동의하면 바로 설치합니다.
기본 사용법
co doctor출력 예시:
✔ git git version 2.39.5
✔ ssh installed
! git-lfs not installed — needed only for repositories that use Git LFS
✔ login alice @ https://collabops.ai
! git setup SSH key, signing or HTTPS helper not set up for https://collabops.ai
→ co auth login점검 항목
| 항목 | 확인 내용 | 문제가 있을 때 |
|---|---|---|
| git | 설치 여부와 버전 (2.36 이상) | 설치 명령 제안 · 2.36 미만이면 업그레이드 안내 |
| ssh | ssh 설치 여부 — SSH 로 clone·push 할 때 필요 | 경고만 표시 |
| git-lfs | git-lfs 설치 여부 — LFS 를 쓰는 저장소에만 필요 | 경고만 표시 |
| login | co 로그인 세션이 유효한지 | co auth login 안내 |
| git setup | SSH 키 등록 · 커밋 서명 · HTTPS 자격증명 연동 | co auth login 과 같은 설정 화면을 바로 띄움 (y/N) |
git 설치
git 이 없으면 아래 명령 중 이 컴퓨터에 맞는 것을 보여줍니다.
| OS | 실행하는 명령 |
|---|---|
| macOS | brew install git (Homebrew 가 있을 때) · 없으면 xcode-select --install |
| Windows | winget install --id Git.Git -e --source winget |
| Linux | apt-get · dnf · yum · zypper · pacman · apk 중 설치된 패키지 관리자 (root 가 아니면 sudo 를 붙임) |
명령은 항상 실행 전에 y/N 으로 묻습니다 (기본값 N). 터미널이 아닌 환경(CI, 스크립트)에서는 명령만 출력하고 실행하지 않습니다. 맞는 설치 방법이 없으면 https://git-scm.com/downloads 를 안내합니다.
macOS 의 xcode-select --install 은 설치 창을 띄우고 바로 끝납니다. 설치 창에서 설치를 마친 뒤 co doctor 를 다시 실행하세요.
종료 코드
git 이 없거나 로그인되어 있지 않으면 0 이 아닌 값으로 끝납니다. 스크립트나 온보딩 안내에서 사전 점검용으로 쓸 수 있습니다. co repo clone 도 git 이 없으면 서버에 요청하기 전에 멈추고 co doctor 를 안내합니다.