Installation
Prerequisites
Section titled “Prerequisites”Before installing SCC, ensure you have:
| Requirement | Minimum Version | Check Command |
|---|---|---|
| Python | 3.10+ | python --version |
| uv (recommended) | Latest | uv --version |
| Docker Desktop | 4.50+ | docker --version |
| Git | 2.30+ | git --version |
Installing uv
Section titled “Installing uv”If you don’t have uv installed yet, get it from astral.sh/uv:
curl -LsSf https://astral.sh/uv/install.sh | shpowershell -c "irm https://astral.sh/uv/install.ps1 | iex"pip install uvInstall SCC CLI
Section titled “Install SCC CLI”uv tool install scc-cli# pipx installs in isolated environmentpipx install scc-clipip install scc-cliVerify Installation
Section titled “Verify Installation”-
Check SCC is installed
Terminal window scc --versionYou should see output like
scc-cli 1.5.0 -
Run diagnostics
Terminal window scc doctorThis checks:
- Docker is running and accessible
- Docker version meets requirements
- Git is configured
- Config directories exist
-
Review any warnings
If
scc doctorshows issues, address them before proceeding.
Platform-Specific Notes
Section titled “Platform-Specific Notes”- Install Docker Desktop from docker.com
- Ensure Docker Desktop is running (check menu bar icon)
- No additional configuration needed
- Docker Desktop or Docker Engine works
- Ensure your user is in the
dockergroup:Terminal window sudo usermod -aG docker $USER# Log out and back in for changes to take effect
- Install Docker Desktop with WSL2 backend
- Run SCC from within WSL2, not PowerShell
- File operations may be slower due to WSL filesystem translation
Updating SCC
Section titled “Updating SCC”uv tool upgrade scc-clipipx upgrade scc-clipip install --upgrade scc-cliOr use the built-in update command:
scc updateNext Steps
Section titled “Next Steps”Now that SCC is installed, configure it and run your first session →