← All extensions

Bubble

v0.0.1 · by Ian McLaughlin · added 3 November 2026

See exception flow through your Python codebase

Language servers
Install in Forge SuperView the source

How to install

With Forge Super installed, the button above opens the app on this extension, where you press Install. Nothing is installed until you do.

You can also open the Extensions panel in the app and search for Bubble. The extension's id is bubble-lsp.

Don't have Forge Super yet? Download it here.

README

From the extension's repository, written by its authors and not by Mentenaz. See the source.

Bubble for Zed

See exception flow through your Python codebase directly in Zed.

What it does

Hover over Python code to see exception information:

  • def lines: Shows all exceptions that can escape from the function (uncaught, framework-handled, caught locally, caught by global handler)
  • Function calls: Shows what exceptions the callee can throw
  • Everything else: No popup (no noise)

Requirements

Install bubble-analysis with LSP support in your project's Python environment:

pip install bubble-analysis[lsp]

The extension finds python3 on your PATH and runs python -m bubble.lsp.

Configuration

Override the Python binary or arguments in your Zed settings (settings.json):

{
  "lsp": {
    "bubble-lsp": {
      "binary": {
        "path": "/path/to/your/venv/bin/python",
        "arguments": ["-m", "bubble.lsp"]
      }
    }
  }
}

How it works

The extension spawns a Python LSP server that:

  1. Builds a program model of your codebase on first hover
  2. Propagates exceptions through the call graph (cached after first run)
  3. Returns context-sensitive hover info based on cursor position

The model rebuilds automatically when you save a file.

Supported frameworks

Exception flow analysis supports Flask, FastAPI, and CLI scripts. Framework-specific exceptions (like HTTPException) are recognized and categorized appropriately.