vibe.web_core.devtools

Chrome DevTools automatic workspace folders support.

This module implements the /.well-known/appspecific/com.chrome.devtools.json endpoint that allows Chrome DevTools to automatically discover and configure workspace folders for local development.

Documentation: https://chromium.googlesource.com/devtools/devtools-frontend/+/main/docs/ecosystem/automatic_workspace_folders.md

This endpoint is only available in debug mode and is NOT subject to the mount_path setting - it must always be available at root.

WSL Support: When running in WSL, the workspace path is automatically converted to a Windows-accessible path using the wsl.localhost UNC format. This can be overridden with the DEVTOOLS_WORKSPACE_ROOT config option.

create_devtools_wsgi_app 

create_devtools_wsgi_app(debug: bool, config_workspace_root: str | None = None) -> WSGIApplication

Create a minimal WSGI app that serves the DevTools JSON.

This is a standalone WSGI app (not Flask) so it can be mounted independently of the main Flask app's mount_path.

Parameters:
  • debug (bool) –

    Whether the main app is in debug mode.

  • config_workspace_root (str | None, default: None ) –

    Optional explicit workspace root from config.
Returns:
  • WSGIApplication –

    A WSGI callable.

register_devtools_route 

register_devtools_route(app: Flask) -> None

Register the DevTools endpoint as a Flask route.

This is used when there's no mount_path configured, so the route can be served directly by Flask.