A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.
Python artificial-intelligencedagdata-sciencedata-visualizationdataflowdeveloper-toolsmachine-learningnotebookspipelinepythonreactivesqlweb-app
fix: point pair agents at marimo edit when no session exists (#11055)
Kiran Gadhave9f34a5106ec7
diff --git a/marimo/_cli/pair/commands.py b/marimo/_cli/pair/commands.pyindex 895a8df7a4..50740e8466 100644--- a/marimo/_cli/pair/commands.py+++ b/marimo/_cli/pair/commands.py@@ -208,10 +208,11 @@ class _DocsCommand(ColoredCommand):Authentication:If a token-file path is supplied, add --token-file <PATH> to everyexecute and notebook list command. Pass the path, not the file contents.- Otherwise, these commands use MARIMO_TOKEN when set.\bWorkflow:+ If no server is running, start one in the background:+ marimo edit <notebook.py> --no-tokenIf you do not have the server URL or notebook file:marimo pair notebook listmarimo pair execute --url <URL> --file <FILE> --code-file - <<'PY'@@ -250,6 +251,7 @@ class _DocsCommand(ColoredCommand):the project; confirm when the user did not ask.If an empty cell exists, edit_cell it instead of creating one.delete_cell drops the cell's variables. Ask before deleting.+ Do not edit the notebook file directly. Code mode is the only write path.\bCode-mode API:@@ -297,7 +299,7 @@ def pair() -> None:"--token-file",type=click.Path(path_type=Path, dir_okay=False),metavar="PATH",- help="Read the server token from a local file. Otherwise use MARIMO_TOKEN, if set.",+ help="Read the server token from a local file.",)@click.option("-c",@@ -398,9 +400,9 @@ def execute(_TOKEN_NEXT = (- "Pass --token-file <path> or set MARIMO_TOKEN. "- 'Check it with `test -n "$MARIMO_TOKEN"`. Never print the token. '- "If you have no token, ask the user."+ "Pass --token-file <path>. If no file exists, check for MARIMO_TOKEN "+ 'with `test -n "$MARIMO_TOKEN"`; the commands use it when set. '+ "Never print the token. If you have no token, ask the user.")_HEADLESS_NEXT = ("A headless server has no session until a browser opens the notebook."@@ -808,7 +810,7 @@ def notebook() -> None:"--token-file",type=click.Path(path_type=Path, dir_okay=False),metavar="PATH",- help="Read the server token from a local file. Otherwise use MARIMO_TOKEN, if set.",+ help="Read the server token from a local file.",)def list_notebooks(urls: tuple[str, ...], token_file: Path | None) -> None:try:@@ -836,14 +838,16 @@ def list_notebooks(urls: tuple[str, ...], token_file: Path | None) -> None:listing: dict[str, object] = {"notebooks": notebooks, "warnings": warnings}if any("Authentication failed" in warning for warning in warnings):listing["next"] = (- "Pass --token-file <path> or set MARIMO_TOKEN, then run notebook "- "list --url again. Never print the token."+ "Pass --token-file <path>, then run notebook list --url again. "+ "If no file exists, check for MARIMO_TOKEN with "+ '`test -n "$MARIMO_TOKEN"`. Never print the token.')elif not notebooks:listing["next"] = (- f"No sessions found. {_HEADLESS_NEXT} If you know the server "- "URL, pass --url. If the server needs a token, pass --token-file "- "or set MARIMO_TOKEN."+ "No sessions found. If a server is running, pass --url, and "+ "--token-file <path> if it needs a token. Otherwise start one in "+ "the background: `marimo edit <notebook.py> --no-token`, then run "+ "`marimo pair notebook list` again.")click.echo(json.dumps(listing, indent=2))diff --git a/tests/_cli/test_cli_pair.py b/tests/_cli/test_cli_pair.pyindex 25c0d23e06..050a390555 100644--- a/tests/_cli/test_cli_pair.py+++ b/tests/_cli/test_cli_pair.py@@ -60,9 +60,10 @@ Usage: main pair [OPTIONS] COMMAND [ARGS]...Authentication:If a token-file path is supplied, add --token-file <PATH> to everyexecute and notebook list command. Pass the path, not the file contents.- Otherwise, these commands use MARIMO_TOKEN when set.Workflow:+ If no server is running, start one in the background:+ marimo edit <notebook.py> --no-tokenIf you do not have the server URL or notebook file:marimo pair notebook listmarimo pair execute --url <URL> --file <FILE> --code-file - <<'PY'@@ -99,6 +100,7 @@ Usage: main pair [OPTIONS] COMMAND [ARGS]...the project; confirm when the user did not ask.If an empty cell exists, edit_cell it instead of creating one.delete_cell drops the cell's variables. Ask before deleting.+ Do not edit the notebook file directly. Code mode is the only write path.Code-mode API:Prefer marimo._code_mode to inspect, create, edit, run, and delete notebook cells.@@ -158,8 +160,7 @@ Options:--session ID Current session ID. Resolved from --file when omitted.--file PATH Notebook path or file key. Used to resolve --session whenomitted.- --token-file PATH Read the server token from a local file. Otherwise use- MARIMO_TOKEN, if set.+ --token-file PATH Read the server token from a local file.-c TEXT Inline Python.--code-file PATH Read Python from a UTF-8 file, or from stdin when PATH is'-'. Supply exactly one input option.@@ -1005,8 +1006,7 @@ Usage: main pair notebook list [OPTIONS]Options:--url URL Server URL. Repeat to list more than one server.- --token-file PATH Read the server token from a local file. Otherwise use- MARIMO_TOKEN, if set.+ --token-file PATH Read the server token from a local file.-h, --help Show this message and exit.""")@@ -1267,6 +1267,7 @@ Options:)]assert payload["next"].startswith("No sessions found.")+ assert "marimo edit <notebook.py> --no-token" in payload["next"]def test_list_empty_registry_succeeds(self, monkeypatch: pytest.MonkeyPatch@@ -1285,6 +1286,7 @@ Options:assert payload["notebooks"] == []assert payload["warnings"] == []assert payload["next"].startswith("No sessions found.")+ assert "marimo edit <notebook.py> --no-token" in payload["next"]def test_list_uses_token_only_for_explicit_urls(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path