Common Issues

Configuration Not Loading

Symptoms: Old settings, missing plugins

Fix:

scc update --force
scc config explain

Plugin Blocked

Symptoms: Plugin not appearing in scc audit plugins

Cause: Matches security.blocked_plugins pattern

Fix: Check with org admin or use exception:

scc config explain --field blocked

Delegation Denied

Symptoms: Cannot add plugins in project

Cause: Team doesn’t allow project overrides

Fix:

scc config explain --field denied

Wrong Team

Symptoms: Unexpected configuration

Fix:

scc team current
scc team switch <correct-team>

Session Won’t Resume

Fix:

scc sessions  # List sessions
scc sessions --all  # Show all teams (if needed)
scc stop --all  # Clean up
scc start --fresh  # New session

Reset Configuration

Symptoms: Want to start fresh, corrupt config, need to change organization

Option 1 - Interactive TUI:

Press s from the dashboard to open Settings & Maintenance, then select “Reset configuration”.

Option 2 - CLI:

# Reset config only (will need to run scc setup again)
scc reset --config

# Preview what would be reset
scc reset --config --plan

# Full factory reset (removes everything)
scc reset --all

Option 3 - Manual:

# Find your config files
scc config paths

# Delete and reconfigure
rm ~/.config/scc/config.json
scc setup

Clear Cache

Symptoms: Stale org config, outdated marketplace data

Fix:

# From TUI: press 's' → Clear cache
# Or from CLI:
scc reset --cache

Too Many Old Sessions

Fix:

# Prune old sessions (keeps 20 most recent per team)
scc sessions prune

# Preview what would be removed
scc sessions prune --dry-run

# Keep only last 10 sessions
scc sessions prune --keep 10