co doctor — environment check
Check git, SSH and login, and install git
co doctor checks that this computer is ready to work with CollabOps repositories. When git is missing, it shows the install command for your OS and runs it once you agree.
Basic usage
co doctorExample output:
✔ 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 loginWhat it checks
| Item | What is checked | When something is wrong |
|---|---|---|
| git | Installed, and version 2.36 or later | Offers the install command · asks to upgrade below 2.36 |
| ssh | ssh is installed — needed to clone and push over SSH | Warning only |
| git-lfs | git-lfs is installed — needed only for repositories that use LFS | Warning only |
| login | Your co session is valid | Points to co auth login |
| git setup | SSH key registration · commit signing · HTTPS credential helper | Opens the same setup screen as co auth login (y/N) |
Installing git
When git is missing, co shows the command that fits this computer.
| OS | Command |
|---|---|
| macOS | brew install git (when Homebrew is installed) · otherwise xcode-select --install |
| Windows | winget install --id Git.Git -e --source winget |
| Linux | Whichever of apt-get · dnf · yum · zypper · pacman · apk is installed (prefixed with sudo when not root) |
co always asks y/N before running anything (default N). Outside a terminal (CI, scripts) it only prints the commands. When no install method fits, it points to https://git-scm.com/downloads.
On macOS, xcode-select --install opens an installer window and returns right away. Finish the install there, then run co doctor again.
Exit code
co doctor exits non-zero while git is missing or you are not logged in, so scripts and onboarding guides can use it as a pre-check. co repo clone also stops before contacting the server when git is missing, and points to co doctor.