sprawl init

DNA Governance

Clones your Sovereign DNA globally (~/.sprawl/core) and links the CLI.

📌 1. The Target Problem

1. The Target Problem

"How do I import and register our company's centralized DNA rules, skills, and workflows onto my local workstation?"

When setting up Sprawl for the first time or moving to a new workstation, developers need to clone and link their team's centralized context registries and guidelines. Doing this manually is prone to directory mismatches and layout drift.

⚙️ 2. Usage & Options

sprawl init <GIT_URL> [target_dir]

Options & Flags

  • -h, --help: Show this help message and exit.
  • --verbose: Engages strict logging mode dumping tracking execution outputs.
  • --dry-run: Safety mode; simulates structural file logic without destroying paths.

🔍 3. How it Works (Under the Hood)

  1. Clones the remote DNA git repository directly to your global Sprawl storage path (default: ~/.sprawl/core/).
  2. Registers the DNA source alias globally.
  3. Validates the directory hierarchy structure of the cloned DNA guidelines to ensure compliance with the Sprawl standard.

🩺 4. Troubleshooting

  • Error: Authentication failed during git clone
  • Resolution: Sprawl init relies on local SSH keys or git credentials to pull private DNA repositories. Ensure your workstation has SSH access configured for the target repository.

🔗 Related Resources & Tutorials