sprawl wipe

Diagnostics & Advanced

Completely and cleanly uninstalls all Sprawl-generated directories, global registries, and editor configs.

📌 1. The Target Problem

1. The Target Problem

"How do I completely and cleanly uninstall all Sprawl-generated directories, global registries, and editor configs without leaving configuration trails on my machine?"

When shifting between workstations or removing toolchains, you want to leave no trace of Sprawl configuration settings, virtual environments, or symlinks behind.

⚙️ 2. Usage & Options

sprawl wipe [target_dir] [--force] [--local-only]

Options & Flags

  • --force: Bypass verification confirmation checks and delete files immediately.
  • --local-only: Only wipe the local workspace .agents/ folder, preserving global registries.

🔍 3. How it Works (Under the Hood)

  1. Deletes the local .agents/ directory inside target workspaces.
  2. Cleans up and removes local editor symlinks and config files.
  3. Deregisters workspace directories from global databases.
  4. Deletes the global configurations folder inside ~/.sprawl/ (unless --local-only is provided).

🩺 4. Troubleshooting

  • Wipe does not delete the spraw CLI command itself
  • Resolution: Sprawl wipe only deletes settings directories and configs. To remove the binary itself, execute pipx uninstall sprawl-cli.

🔗 Related Resources & Tutorials