sprawl status

Diagnostics

Displays workspace status, DNA binding, artifacts, and venv health.

📌 1. The Target Problem

1. The Target Problem

"How do I check my workspace identity, active DNA bindings, installed files vs manifest requirements, and telemetry database health?"

Without a local status overview, developers and security auditors cannot quickly verify if their rules are out-of-sync, if their virtual environments are healthy, or if local IDE SQLite databases are being harvested correctly for session telemetry.

⚙️ 2. Usage & Options

sprawl status [target_dir]

Options & Flags

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

🔍 3. How it Works (Under the Hood)

  1. Queries the central workspaces tracking database inside ~/.sprawl/workspaces/.
  2. Parses .agents/sprawl_manifest.yml and matches local .agents/ layout.
  3. Inspects the Python executable inside .agents/.venv and returns rich diagnostic stats.

🩺 4. Troubleshooting

  • Venv status shows as missing or corrupted
  • Resolution: Your virtual environment was deleted or moved. Run sprawl sync to restore the sandboxed python environment.

🔗 Related Resources & Tutorials