Skip to content
SCC CLI

Getting Help

Diagnostic Commands

Section titled “Diagnostic Commands”

SCC includes several diagnostic tools:

Terminal window
# Full health check (all providers)
scc doctor


# Check a specific provider
scc doctor --provider codex


# Inspect recent launch diagnostics
scc support launch-audit


# Inspect recent safety-check events
scc support safety-audit


# Check config sources and effective settings
scc config explain


# Verify plugins
scc audit plugins

Create a Support Bundle

Section titled “Create a Support Bundle”

Generate a bundle for troubleshooting:

Terminal window
scc support bundle

This creates a zip file with:

  • Configuration (secrets redacted)
  • Recent launch audit entries
  • Safety audit entries
  • System information
  • Container runtime status
  • Provider readiness states

GitHub Issues

Section titled “GitHub Issues”

Report bugs or request features:

github.com/CCimen/scc/issues

Include:

  1. SCC version (scc --version)
  2. OS and container runtime (Docker Engine, OrbStack, Colima, or Docker Desktop)
  3. Provider (Claude Code, Codex, or both)
  4. What you tried
  5. What happened
  6. Support bundle (if applicable)

Self-Diagnosis Checklist

Section titled “Self-Diagnosis Checklist”

Before opening an issue:

Terminal window
# Full diagnostic
scc doctor


# Check a specific provider's readiness
scc doctor --provider claude


# Check config sources
scc config explain


# Verify plugins
scc audit plugins


# Check team config
scc team validate <team>


# Inspect launch failures
scc support launch-audit


# Inspect safety engine events
scc support safety-audit

Documentation

Section titled “Documentation”