Skip to content
SiftSift

Doctor

sift doctor is a read-only filesystem diagnostic. It never mutates anything, regardless of flags.

Terminal window
sift doctor ~/Downloads
sift doctor ~/Downloads --recursive
sift doctor ~/Downloads --json

What it reports

Section titled “What it reports”
  • software projects;
  • protected directories;
  • symlinks;
  • hidden entries;
  • sensitive-looking filenames;
  • files larger than 100 MB;
  • archives older than one year;
  • known build/dependency output directories (node_modules, target, .venv).
Issues found


⚠ SLACK_TOKEN.txt
  Sensitive-looking filename


⚠ my-project/
  Software project detected — protected


⚠ some-link
  Symlink


3 findings

The sensitive-filename check is filename-based only — Sift does not read file contents to produce it.

Recursive

Section titled “Recursive”
Terminal window
sift doctor ~/Downloads --recursive

Uses the same traversal boundaries as organize --recursive (see Recursive Organization) — inspects eligible subdirectories, but reads no file contents either way.

Section titled “Related”
  • Explain — a decision-focused read-only check for one specific file, instead of a directory-wide report.