📖 Situational Tutorial: Multi-Repository Workspace Management

Summary: Learn how to list registered projects, verify synchronization states, and push team DNA updates across all developer codebases in a single command.

📌 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?"

Auditing security rules on dozens of active repositories scattered across a workstation is difficult. Developers forget which projects are secured, and microservices fall out-of-sync with compliance updates.

🚀 2. Step-by-Step Walkthrough

Step 1: List All Tracked Workspaces

Query the global workspace tracking registry database to display active developer sandboxes and synchronization timestamps:

sprawl ws list

Step 2: Push Central DNA Updates in Bulk

Push rules updates across all tracked workspace directories and trigger automated sync procedures:

sprawl ws push

This loops through every registered repository path, downloads updated DNA core rules, rebuilds AGENTS.md context files, and refreshes IDE configurations.

Step 3: Prune Missing Workspace Registries

If workspaces have been deleted or moved, deregister them from the global database:

sprawl ws remove stale-project

Step 4: Verify the Global State

Review the registry to confirm all active projects are fully synced:

sprawl ws list

🩺 Troubleshooting

  • Workspace status icon shows empty (○)
  • Cause: The project folder has been deleted or moved from its registered absolute path.
  • Resolution: Run sprawl ws remove <name> to clear the stale entry from global tracking.

🔗 Related Resources & Tutorials