Notebook

---
name: notebook
description: "Use Fugue's Jupyter and IPython notebook extension, %%fsql magic,
  and notebook display setup."
metadata:
  disco-role: operating
disable-model-invocation: true
license: Apache 2.0
---

# notebook

Use this sub-skill for Fugue notebook integration and `%%fsql` cell magic.

## Covers

- `%load_ext fugue_notebook`
- `from fugue_notebook import setup, NotebookSetup`
- `%%fsql` cell magic, line engine parsing, and yielded local variables
- notebook display behavior for Fugue dataframes
- notebook-specific case-sensitivity and config controls

## Excludes

- Full FugueSQL grammar and query construction, which belong in `../sql/`
- Backend package installation and engine registration, which belong in `../backends/`
- Plain Python DAG code outside notebooks, which belongs in `../workflow/`

## Read these files

- `references/notebook-reference.md` for notebook setup, line syntax, and config examples
- `references/troubleshooting.md` for magic-registration and headless/runtime failures
- `scripts/notebook_smoke.py` for a safe import check that can optionally register magics inside IPython

## Typical user prompts

- "How do I use FugueSQL in a notebook cell?"
- "Why is %%fsql not recognized?"
- "How do I force FugueSQL cells to ignore case?"
- "How do I pass a Dask or DuckDB engine into %%fsql?"

If the user is writing SQL text rather than debugging notebook setup, route to `../sql/` after confirming the magic is loaded.