sprawl ws

Multi-Workspace

Lists, removes, and pushes DNA updates across all tracked workspaces.

📌 1. The Target Problem

1. The Target Problem

"How do I manage, list, deregister, or mass-update (push changes to) all tracked workspace directories from a single centralized management registry?"

As you scale your AI workflows, you accumulate dozens of sandboxed workspaces. Manually checking their synchronisation states, cleaning up stale paths, or updating them one-by-one is tedious and error-prone.

⚙️ 2. Usage & Options

sprawl ws <list|remove|push>

Options & Flags

  • list: List all tracked workspaces, their path, DNA binding, and status.
  • remove <name> [--delete]: Deregisters the workspace. If --delete is specified, deletes the directory from disk.
  • push: Bulk-pushes DNA updates and triggers synchronization across all tracked workspaces.

🔍 3. How it Works (Under the Hood)

  1. Reads workspace paths registered inside ~/.sprawl/workspaces/ tracking database.
  2. Validates existence of directories, comparing timestamps to determine synchronization status.
  3. Iterates over workspaces during push to run automated clean-room synchronisation routines.

🩺 4. Troubleshooting

  • Workspace status icon shows empty (○)
  • Resolution: The target workspace directory was moved or deleted outside of Sprawl. Run sprawl ws remove <name> to clear it from global tracking.

🔗 Related Resources & Tutorials