Skip to main content

synapsync clean

Clean cache, orphaned symlinks, and temporary files.

Usage

synapsync clean [options]

Options

OptionDescription
--cacheClean registry cache only
--orphansClean orphaned symlinks only
--tempClean temp files only
--allClean everything
--dry-runPreview what would be cleaned
--jsonJSON output

What Gets Cleaned

TargetLocationDescription
Cache.synapsync/cache/Registry response cache
OrphansProvider directoriesSymlinks pointing to deleted cognitives
Temp.synapsync/temp/Temporary download files

Examples

Preview Cleanup

synapsync clean --dry-run
[DRY RUN] Would clean:

Cache:
• registry-cache.json (2.3 KB)
• search-cache.json (1.1 KB)

Orphaned symlinks:
• .claude/skills/old-skill/
• .cursor/agents/removed-agent.md

Temp files:
• download-abc123.tmp

Total: 5 items (3.4 KB)

Clean Everything

synapsync clean --all
Cleaning...

✓ Removed 2 cache files (3.4 KB)
✓ Removed 2 orphaned symlinks
✓ Removed 1 temp file

Freed 3.4 KB

Clean Only Cache

synapsync clean --cache

Clean Only Orphans

synapsync clean --orphans

Useful after uninstalling cognitives.

JSON Output

synapsync clean --all --json
{
"cache": {
"files": 2,
"bytes": 3481
},
"orphans": {
"symlinks": 2
},
"temp": {
"files": 1,
"bytes": 1024
},
"total": {
"items": 5,
"bytes": 4505
}
}

When to Clean

  • After uninstalling multiple cognitives (--orphans)
  • If search results seem stale (--cache)
  • To free disk space (--all)
  • Before troubleshooting (--all)

Notes

  • --dry-run is recommended before --all
  • Cleaning cache may slow next registry query
  • Orphaned symlinks don't affect functionality but clutter directories