sprawl create

Workspace Lifecycle

Scaffolds a new standard workspace bound to Sovereign DNA.

📌 1. The Target Problem

1. The Target Problem

"How do I instantiate a new development workspace that complies with our team's AI governance policies, without copying over configs manually?"

When starting a new project, developers have to manually copy over .cursorrules, set up local model exclusion files, and copy prompt instructions. This leads to configuration errors, missing safety guidelines, and environment leakage.

⚙️ 2. Usage & Options

sprawl create <workspace> [--path PATH]

Options & Flags

  • --path <path>: Specify a custom directory to create the project in. Defaults to the current directory.
  • -y, --non-interactive: Bypass setup questionnaires and use default configuration templates.

🔍 3. How it Works (Under the Hood)

  1. Initializes the target project directory paths securely.
  2. Provisions a clean local .agents/ folder and registers a default sprawl_manifest.yml template.
  3. Registers the new workspace path in the global tracking database stored at ~/.sprawl/workspaces/.

🩺 4. Troubleshooting

  • Error: Path already exists
  • Resolution: Select a clean folder or specify a custom destination path using the --path option.

🔗 Related Resources & Tutorials