sprawl sync

Sandboxing & DNA

Injects DNA into local scope and provisions sandboxes (.venv, npm, cargo).

📌 1. The Target Problem

1. The Target Problem

"How do I ensure my workspace virtual environment is provisioned and all agent IDE bindings are freshly compiled when DNA rules are updated?"

When you pull updates to your global DNA rules registry, your active local workspaces fall out-of-sync. Running agents might continue using stale configurations, or their virtual environments might lack required dependencies, causing agent failures.

⚙️ 2. Usage & Options

sprawl sync [target_dir]

Options & Flags

  • target_dir: Optional workspace path (defaults to current folder).

🔍 3. How it Works (Under the Hood)

  1. Pulls current DNA files, schemas, and instructions matching dependencies in the manifest.
  2. Provisions a local Python virtual environment inside .agents/.venv and installs loaded skills packages.
  3. Aggregates rules files into a compiled, token-optimized AGENTS.md context file.
  4. Regenerates local Claude Desktop/IDE MCP configuration files (mcp_config.json).

🩺 4. Troubleshooting

  • Virtual environment provisioning fails
  • Resolution: Ensure Python 3.10+ and the standard python3-venv library package are present on your operating system.

🔗 Related Resources & Tutorials