Settings & Maintenance

Tip

Press s from the main dashboard to open Settings & Maintenance at any time.

The Settings & Maintenance TUI provides a visual interface for managing SCC’s configuration, clearing cache, and performing maintenance operations — all without leaving the terminal.

Navigation

Key	Action
↑/↓ or j/k	Navigate actions
←/→ or h/l	Switch categories
Tab	Cycle categories
Enter	Execute action
i	Toggle info panel
p	Preview affected paths and sizes
?	Show help panel
Esc / q	Go back / Close panels

Categories

Maintenance

Cache cleanup, session pruning, and configuration reset operations.

Profiles

Save, apply, diff, and sync personal profiles from the TUI.

Diagnostics

Health checks and debugging tools like scc doctor.

About

Version info and file locations (scc config paths).

Maintenance Actions

Each action has a risk tier that determines the confirmation level:

Action	Risk	Description
Clear cache	Safe	Remove regenerable cache files
Clear contexts	Changes State	Clear recent work contexts
Prune containers	Changes State	Remove stopped Docker containers
Prune sessions	Changes State	Remove old sessions (keeps recent 20)
Reset exceptions	Destructive	Clear all policy exceptions
Delete all sessions	Destructive	Remove entire session history
Reset configuration	Destructive	Reset to defaults (requires setup)
Factory reset	Very Destructive	Remove all SCC data

Risk-Tiered Confirmations

Tier 0 (Safe)

Actions like “Clear cache” execute immediately with just a success toast.

No confirmation required — these operations are always safe to run.

Tier 1 (Changes State)

Actions like “Clear contexts” or “Prune containers” show a simple Y/N confirmation.

This will clear work contexts. Continue? [y/N]

Tier 2 (Destructive)

Actions like “Reset configuration” show an impact preview before confirming.

This will reset configuration.

Affected: ~/.config/scc/config.json
You will need to run 'scc setup' again.

Continue? [y/N]

Tier 3 (Factory Reset)

Factory reset requires typing “FACTORY RESET” to confirm.

⚠️  FACTORY RESET will remove ALL SCC data:
- Configuration
- Sessions
- Exceptions
- Cache

Type "FACTORY RESET" to confirm:

Note

This is case-insensitive — “factory reset” also works.

Preview Mode

Press p on any action to see exactly what will be affected before executing:

Clear cache

Paths affected:
  ~/.cache/scc/

Current size: 15.7 KB

Common Workflows

1. Quick cleanup after heavy usage

   Open settings (s), select “Clear cache”, press Enter.

2. Starting fresh with a new organization

   Open settings (s), select “Reset configuration”, confirm, then run scc setup.

3. Cleaning up old sessions

   Open settings (s), select “Prune sessions” to keep only the 20 most recent per team.

CLI Alternative

All TUI actions are also available via CLI using scc reset:

# Clear cache
scc reset --cache

# Clear contexts
scc reset --contexts

# Prune sessions (keeps newest 20 per team)
scc reset --sessions

# Factory reset (interactive confirmation)
scc reset --all

# Non-interactive for scripts
scc reset --cache --yes

Tip

Use scc reset --plan to preview what any operation would do without making changes.

Related

scc reset Reference

Full CLI documentation for all reset flags. View reference →

Troubleshooting

Common issues and how to fix them. Get help →