mycli 2.26.0__tar.gz → 2.27.0__tar.gz

{mycli-2.26.0 → mycli-2.27.0}/.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
-      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           version: "latest"
 
@@ -66,7 +66,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
-      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           version: "latest"
 
@@ -116,7 +116,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
-      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           version: 'latest'
 
@@ -220,7 +220,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
-      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           version: "latest"
 

{mycli-2.26.0 → mycli-2.27.0}/.github/workflows/publish.yml

@@ -32,7 +32,7 @@ jobs:
 
     steps:
     - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-    - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
       with:
         version: "latest"
 
@@ -77,7 +77,7 @@ jobs:
     steps:
     - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
-    - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
       with:
         version: "latest"
 
@@ -127,7 +127,7 @@ jobs:
     steps:
     - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
 
-    - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
       with:
         version: 'latest'
 
@@ -230,7 +230,7 @@ jobs:
 
     steps:
     - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-    - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+    - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
       with:
         version: "latest"
 

{mycli-2.26.0 → mycli-2.27.0}/.github/workflows/typecheck.yml

@@ -25,7 +25,7 @@ jobs:
         with:
           python-version: '3.14'
 
-      - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
         with:
           version: 'latest'
 

{mycli-2.26.0 → mycli-2.27.0}/AGENTS.md

@@ -56,6 +56,7 @@ A command line client for MySQL with auto-completion and syntax highlighting.
     ├── mycli/packages/string_utils.py        # generic string utilities
     ├── mycli/packages/tabular_output/        # extends cli_helper with additional output formats
     ├── mycli/password_sources.py             # password sources and precedence
+    ├── mycli/query_runner.py                 # run queries with query state and timing updates
     ├── mycli/resources/completions/          # shell completions for CLI interface
     ├── mycli/ssh_tunnel.py                   # connecting over a tunnel with `--ssh-jump`
     ├── mycli/schema_prefetcher.py            # background prefetcher for multi-schema auto-completion

{mycli-2.26.0/mycli.egg-info → mycli-2.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mycli
-Version: 2.26.0
+Version: 2.27.0
 Summary: Rich MySQL terminal client with autocompletion, syntax highlighting, and dataframes
 Author: Mycli Core Team
 License-Expression: BSD-3-Clause

{mycli-2.26.0 → mycli-2.27.0}/changelog.md

@@ -1,3 +1,18 @@
+v2.27.0 (2026/09/29)
+==============
+
+Features
+--------
+* Show query state and timings while waiting.
+* Allow composing trailing shell redirections with `.|` transforms.
+
+
+Bug Fixes
+--------
+* Don't treat `-o` as a flag after `$>` redirects.
+* Timed-out shell pipelines no longer report success.
+
+
 v2.26.0 (2026/09/26)
 ==============
 

{mycli-2.26.0 → mycli-2.27.0}/doc/transforms.md

@@ -21,7 +21,6 @@ functionality may still change.
 
 Here are some known limitations:
 
- * transforms can't be composed with `$|` shell redirection
  * composing multiple transform operations is not supported
  * results from `UNION`s may be unable to be transformed
 

{mycli-2.26.0 → mycli-2.27.0}/docker/resources/test_db-1.0.7.tar.gz

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
-name: mycli-2.26.0/docker/resources/test_db-1.0.7.tar.gz
+name: mycli-2.27.0/docker/resources/test_db-1.0.7.tar.gz
 size: 35607473 bytes
 sha256: c44c140f352f35d47fdb65df60f52b779ef552822fad6c4efcfa7b134c3faf84

{mycli-2.26.0 → mycli-2.27.0}/mycli/constants.py

@@ -1,3 +1,5 @@
+import enum
+
 HOME_URL = 'https://mycli.net'
 REPO_URL = 'https://github.com/dbcli/mycli'
 DOCS_URL = f'{HOME_URL}/docs'
@@ -51,3 +53,12 @@ MYSQL_ESCAPES = {
     't': '\t',
     'Z': '\x1a',
 }
+
+TTY_ERASE_LINE = '\r\x1b[2K'
+
+
+class QueryState(enum.StrEnum):
+    RENDERING = 'rendering'
+    TRANSFORMING = 'transforming'
+    UNKNOWN = 'unknown'
+    INITIAL = 'finding state'

{mycli-2.26.0 → mycli-2.27.0}/mycli/main_modes/repl.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from collections.abc import Generator, Iterable
+from contextlib import nullcontext
 from dataclasses import dataclass
 from datetime import datetime
 import functools
@@ -57,6 +58,7 @@ from mycli.constants import (
     ER_MUST_CHANGE_PASSWORD,
     HOME_URL,
     ISSUES_URL,
+    QueryState,
 )
 from mycli.key_bindings import mycli_bindings
 from mycli.lexer import MyCliLexer
@@ -76,6 +78,7 @@ from mycli.packages.polars_transform import (
     run_polars_transform,
 )
 from mycli.packages.ptoolkit.history import FRECENCY_HISTORY_ENTRIES, FRECENCY_REFRESH_INTERVAL, FileHistoryWithTimestamp
+from mycli.packages.special.iocommands import temporary_redirect
 from mycli.packages.special.utils import format_uptime, get_ssl_version, get_uptime, get_warning_count
 from mycli.packages.sql_utils import (
     extract_new_password,
@@ -89,6 +92,7 @@ from mycli.packages.sql_utils import (
 )
 from mycli.packages.sqlresult import SQLResult
 from mycli.packages.string_utils import sanitize_terminal_title
+from mycli.query_runner import QueryCancelled, QueryRunner, runner_for
 from mycli.sqlexecute import SQLExecute
 from mycli.types import Query
 
@@ -452,6 +456,8 @@ def _output_results(
     state: ReplState,
     results: Iterable[SQLResult],
     start: float,
+    *,
+    raise_interrupts: bool = False,
 ) -> None:
     sqlexecute = mycli.sqlexecute
     assert sqlexecute is not None
@@ -468,7 +474,9 @@ def _output_results(
             return
         paged_output = _single_paged_output_results(mycli, state, result_iterator, start)
         try:
-            click.echo_via_pager(paged_output)
+            runner = runner_for(mycli)
+            with runner.suspend_display() if runner else nullcontext():
+                click.echo_via_pager(paged_output)
         except KeyboardInterrupt:
             pass
         finally:
@@ -504,6 +512,8 @@ def _output_results(
                 watch_count += 1
 
         if is_select(result.status_plain) and isinstance(result.rows, Cursor) and result.rows.rowcount > threshold:
+            if runner := runner_for(mycli):
+                runner.reset_progress()
             mycli.echo(
                 f'The result set has more than {threshold} rows.',
                 fg='red',
@@ -537,14 +547,16 @@ def _output_results(
             try:
                 mycli.output(formatted, result)
             except KeyboardInterrupt:
-                pass
+                if raise_interrupts:
+                    raise
             if mycli.beep_after_seconds > 0 and duration >= mycli.beep_after_seconds:
                 assert mycli.prompt_session is not None
                 mycli.prompt_session.output.bell()
             if special.is_timing_enabled():
                 mycli.output_timing(f'Time: {duration:0.03f}s')
         except KeyboardInterrupt:
-            pass
+            if raise_interrupts:
+                raise
 
         start = time.time()
         result_count += 1
@@ -928,38 +940,52 @@ def _one_iteration(
         mycli.log_query(query_history_text)
 
         start = time.time()
+        if runner := runner_for(mycli):
+            runner.reset_progress()
         results = sqlexecute.run(text)
         mycli.main_formatter.query = text
         mycli.redirect_formatter.query = text
         mycli.explorer_formatter.query = text
         if polars_transform is not None:
             assert polars_pipeline is not None
-            if polars_pipeline.output_path is None:
-                polars_result = run_polars_transform(
-                    polars_transform,
-                    results,
-                    image_protocol=mycli.image_protocol,
-                    plot_scale_factor=mycli.plot_scale_factor,
-                    plot_ppi=mycli.plot_ppi,
-                    plot_theme=mycli.plot_theme,
-                )
-            else:
-                polars_result = run_polars_transform(
-                    polars_transform,
-                    results,
-                    polars_pipeline.output_path,
-                    original_query=original_text,
-                    image_protocol=mycli.image_protocol,
-                    plot_scale_factor=mycli.plot_scale_factor,
-                    plot_ppi=mycli.plot_ppi,
-                    plot_theme=mycli.plot_theme,
-                )
+            runner = runner_for(mycli)
+            with runner.rendering(QueryState.TRANSFORMING) if runner else nullcontext():
+                if polars_pipeline.output_path is None:
+                    polars_result = run_polars_transform(
+                        polars_transform,
+                        results,
+                        image_protocol=mycli.image_protocol,
+                        plot_scale_factor=mycli.plot_scale_factor,
+                        plot_ppi=mycli.plot_ppi,
+                        plot_theme=mycli.plot_theme,
+                        allow_plots=polars_pipeline.shell_redirect is None,
+                    )
+                else:
+                    polars_result = run_polars_transform(
+                        polars_transform,
+                        results,
+                        polars_pipeline.output_path,
+                        original_query=original_text,
+                        image_protocol=mycli.image_protocol,
+                        plot_scale_factor=mycli.plot_scale_factor,
+                        plot_ppi=mycli.plot_ppi,
+                        plot_theme=mycli.plot_theme,
+                    )
             if polars_pipeline.output_path is None:
                 if polars_pipeline.output_mode == 'explorer':
                     special.set_explorer_output(True)
                 elif polars_pipeline.output_mode == 'expanded':
                     special.set_expanded_output(True)
-            _output_results(mycli, state, iter([polars_result]), start)
+            redirect = polars_pipeline.shell_redirect
+            try:
+                with (
+                    temporary_redirect(redirect.command, redirect.file_operator, redirect.filename, mycli.post_redirect_command)
+                    if redirect is not None
+                    else nullcontext()
+                ):
+                    _output_results(mycli, state, iter([polars_result]), start, raise_interrupts=redirect is not None)
+            except KeyboardInterrupt:
+                raise QueryCancelled(False) from None
             if polars_pipeline.output_path is not None:
                 special.run_post_redirect_hook(
                     mycli.post_redirect_command,
@@ -970,10 +996,15 @@ def _one_iteration(
             special.unset_once_if_written(mycli.post_redirect_command)
             special.flush_pipe_once_if_written(mycli.post_redirect_command)
         successful = True
+    except QueryCancelled as exc:
+        mycli.echo('Query cancelled.', err=True, fg='blue')
+        if exc.disconnected:
+            mycli.echo('Connection closed. Session state was lost.', err=True, fg='yellow')
+            mycli.reconnect()
     except pymysql.err.InterfaceError:
         if not mycli.reconnect():
             return
-        _one_iteration(mycli, state, text)
+        _one_iteration(mycli, state, original_text if polars_pipeline is not None else text)
         return
     except EOFError as e:
         raise e
@@ -1017,7 +1048,7 @@ def _one_iteration(
         elif e1.args[0] in (2003, 2006, 2013):
             if not mycli.reconnect():
                 return
-            _one_iteration(mycli, state, text)
+            _one_iteration(mycli, state, original_text if polars_pipeline is not None else text)
             return
         else:
             mycli.logger.error('sql: %r, error: %r', text, e1)
@@ -1139,6 +1170,11 @@ def main_repl(mycli: 'MyCli') -> None:
     _build_prompt_session(mycli, state, history, key_bindings)
     set_all_external_titles(mycli)
 
+    config = mycli.config['main']
+    show_state_interval = config.as_float('show_query_state_interval')
+    runner = QueryRunner(show_state_interval)
+    if isinstance(sqlexecute, SQLExecute):
+        sqlexecute.set_query_runner(runner)
     try:
         while True:
             _one_iteration(mycli, state)
@@ -1147,3 +1183,7 @@ def main_repl(mycli: 'MyCli') -> None:
         special.close_tee()
         if mycli.verbosity >= 0:
             mycli.echo('Goodbye!')
+    finally:
+        if isinstance(sqlexecute, SQLExecute):
+            sqlexecute.set_query_runner(None)
+        runner.close()

{mycli-2.26.0 → mycli-2.27.0}/mycli/myclirc

@@ -111,6 +111,12 @@ log_level = INFO
 # Timing of SQL statements and table rendering, or LLM commands.
 timing = True
 
+# Seconds between query state and elapsed time updates, off if zero.  Disabling
+# this saves a second connection to the server.  If set to a very low positive
+# value, would lead to excessive SHOW PROCESSLIST queries.  0.5 is probably a
+# good lower bound.
+show_query_state_interval = 0.5
+
 # Show the full SQL when running a favorite query. Set to False to hide.
 show_favorite_query = True
 

{mycli-2.26.0 → mycli-2.27.0}/mycli/output.py

@@ -35,6 +35,7 @@ import mycli.main_modes.repl as repl_mode
 from mycli.packages import special
 from mycli.packages.sqlresult import SQLResult
 from mycli.packages.tabular_output import sql_format
+from mycli.query_runner import rendering_output, runner_for
 from mycli.sqlexecute import FIELD_TYPES
 
 
@@ -109,6 +110,7 @@ class OutputMixin(MyCliState):
 
         return margin
 
+    @rendering_output
     def output(
         self,
         output: itertools.chain[str],
@@ -116,8 +118,15 @@ class OutputMixin(MyCliState):
         is_warnings_style: bool = False,
     ) -> None:
         """Output text to stdout or a pager command."""
+        runner = runner_for(self)
+
+        def before_output() -> None:
+            if runner:
+                runner.stop_rendering()
+
         prompt_output = self.prompt_session.output if self.prompt_session is not None else None
         if result.image is not None and not is_windows_console(prompt_output):
+            before_output()
             if result.image_protocol == 'iterm2':
                 click.secho('')
                 self.output_iterm2_image(result.image)
@@ -156,13 +165,16 @@ class OutputMixin(MyCliState):
                             output_via_pager = True
 
                         if not output_via_pager:
+                            before_output()
                             for buf_line in buf:
                                 click.secho(buf_line)
                             buf = []
                 else:
+                    before_output()
                     click.secho(line)
 
             if buf:
+                before_output()
 
                 def newlinewrapper(text: list[str]) -> Generator[str, None, None]:
                     for line in text:
@@ -186,6 +198,7 @@ class OutputMixin(MyCliState):
                         click.secho(line)
 
         if result.status:
+            before_output()
             self.log_output(result.status_plain)
             add_style = 'class:warnings.status' if is_warnings_style else 'class:output.status'
             if isinstance(result.status, FormattedText):
@@ -234,6 +247,7 @@ class OutputMixin(MyCliState):
             return bool(shutil.which(cmd[0]))
         return False
 
+    @rendering_output
     def format_sqlresult(
         self,
         result,

{mycli-2.26.0 → mycli-2.27.0}/mycli/packages/hybrid_redirection.py

@@ -1,3 +1,4 @@
+from dataclasses import dataclass
 import functools
 import logging
 import re
@@ -19,6 +20,76 @@ SOURCE_OPTION_TERMINATOR_PATTERN = re.compile(r'(?<!\S)--(?=\s|$)')
 HYBRID_OPERATOR_PATTERN = re.compile(r'\$(?:>>?|\|)')
 
 
+@dataclass(frozen=True, slots=True)
+class ShellRedirect:
+    command: str | None
+    file_operator: str | None
+    filename: str | None
+
+
+def tokenize_shell_suffix(suffix: str) -> list[sqlglot.Token]:
+    # Shell long options are not SQL comments; preserve offsets into the original text.
+    for match in re.finditer(r'\$\s*>', suffix):
+        prefix = re.sub(r'--(?=\S)', '__', suffix[: match.end()])
+        try:
+            tokens = sqlglot.tokenize(prefix)
+        except sqlglot.errors.TokenError:
+            continue
+        files = find_token_indices(tokens)['angle_bracket']
+        if files and tokens[files[-1]].end == match.end() - 1:
+            # Only an unquoted file operator switches back to SQL comment handling.
+            operand = re.sub(r'(?<=\S)--', '__', suffix[match.end() :])
+            return sqlglot.tokenize(prefix + operand)
+    return sqlglot.tokenize(re.sub(r'--(?=\S)', '__', suffix))
+
+
+def parse_shell_redirect(suffix: str) -> ShellRedirect:
+    """Parse a final shell suffix independently of the SQL or transform preceding it."""
+    suffix = suffix.strip().removesuffix(delimiter_command.current).rstrip()
+    tokens = tokenize_shell_suffix(suffix)
+    indices = find_token_indices(tokens)
+    dollars = indices['true_dollar']
+    pipes = indices['pipe']
+    files = indices['angle_bracket']
+    if not dollars or tokens[dollars[0]].start != 0:
+        raise ValueError('Shell redirection requires an operator.')
+    if len(files) > 1 or (files and pipes and pipes[-1] > files[0]):
+        raise ValueError('Shell file redirection must be last and occur only once.')
+    if WIN and len(pipes) > 1:
+        raise ValueError('Multiple shell pipes are not supported on Windows.')
+
+    command_parts: list[str] = []
+    for position, dollar in enumerate(dollars):
+        operator = tokens[dollar + 1]
+        next_dollar = dollars[position + 1] if position + 1 < len(dollars) else len(tokens)
+        if operator.token_type == sqlglot.TokenType.PIPE:
+            end = len(suffix[: tokens[next_dollar - 1].end + 1].removesuffix(delimiter_command.current).rstrip())
+            last_token = next(token for token in reversed(tokens[:next_dollar]) if token.start < end)
+            part = suffix[operator.end + 1 : min(last_token.end + 1, end)].strip()
+            if not part:
+                raise ValueError('Shell pipes require a command.')
+            command_parts.append(part)
+
+    filename = None
+    file_operator = None
+    if files:
+        operator = tokens[files[0]]
+        end = len(suffix[: tokens[-1].end + 1].removesuffix(delimiter_command.current).rstrip())
+        last_token = next(token for token in reversed(tokens) if token.start < end)
+        operand = suffix[operator.end + 1 : min(last_token.end + 1, end)].strip()
+        file_operator = '>'
+        if operand.startswith('>'):
+            file_operator = '>>'
+            operand = operand[1:].strip()
+        filename = parse_redirect_filename(operand)
+        if not filename:
+            raise ValueError('Shell file redirection requires one filename; quote filenames containing spaces.')
+    command = ' | '.join(command_parts) or None
+    if invalid_shell_part(filename, command):
+        raise ValueError('Invalid shell redirection.')
+    return ShellRedirect(command, file_operator, filename)
+
+
 def tokenize_command(command: str) -> list[sqlglot.Token]:
     """Tokenize a command without treating source options as SQL comments."""
     if SOURCE_COMMAND_PATTERN.match(command):
@@ -200,34 +271,11 @@ def get_redirect_components(command: str) -> tuple[str | None, str | None, str |
     if not sql_part:
         return None, None, None, None
 
-    (
-        file_part_tokens,
-        file_part_index,
-        file_operator_part,
-    ) = find_file_tokens(
-        tokens,
-        token_indices['angle_bracket'],
-    )
-
-    command_part_tokens = find_command_tokens(
-        tokens[0:file_part_index],
-        token_indices['true_dollar'],
-    )
-
-    if file_part_tokens:
-        file_part = parse_redirect_filename(assemble_tokens(file_part_tokens))
-        if file_part is None:
-            return None, None, None, None
-    else:
-        file_part = None
-
-    if command_part_tokens:
-        command_part = assemble_tokens(command_part_tokens)
-    else:
-        command_part = None
-
-    if invalid_shell_part(file_part, command_part):
+    try:
+        redirect = parse_shell_redirect(command[tokens[token_indices['true_dollar'][0]].start :])
+    except (ValueError, sqlglot.errors.TokenError):
         return None, None, None, None
+    command_part, file_operator_part, file_part = redirect.command, redirect.file_operator, redirect.filename
 
     logger.debug('redirect parse sql_part: "{}"'.format(sql_part))
     logger.debug('redirect parse command_part: "{}"'.format(command_part))

{mycli-2.26.0 → mycli-2.27.0}/mycli/packages/polars_completion.py

@@ -14,6 +14,7 @@ from typing import Any, Union, cast, get_args, get_origin
 
 import sqlglot
 
+from mycli.packages.hybrid_redirection import find_token_indices
 from mycli.packages.polars_transform import _pipeline_operator_indexes
 
 _ATTRIBUTE_PATTERN = re.compile(r'(?s)(.*)\.([A-Za-z_][A-Za-z0-9_]*)?\s*$')
@@ -40,6 +41,8 @@ def complete_polars_transform(command: str) -> list[PolarsCompletion] | None:
         return None
     if pipe_index is None:
         return None
+    if find_token_indices(tokens)['true_dollar']:
+        return []
     if output_index is not None:
         return []
 

{mycli-2.26.0 → mycli-2.27.0}/mycli/packages/polars_transform.py

@@ -11,6 +11,7 @@ from typing import Any, Iterable, Sequence
 
 import sqlglot
 
+from mycli.packages.hybrid_redirection import ShellRedirect, find_token_indices, parse_shell_redirect, tokenize_shell_suffix
 from mycli.packages.special.delimitercommand import DelimiterCommand
 from mycli.packages.sqlresult import SQLResult
 from mycli.types import ImageProtocol, OutputMode
@@ -30,6 +31,7 @@ class PolarsPipeline:
     expression: str | None
     output_path: str | None
     output_mode: OutputMode
+    shell_redirect: ShellRedirect | None = None
 
 
 @dataclass(frozen=True, slots=True)
@@ -69,8 +71,29 @@ def parse_polars_transform(command: str) -> PolarsPipeline | None:
 
     pipe_index, parquet_index = _pipeline_operator_indexes(command, tokens)
 
+    shell_indexes = find_token_indices(tokens)['true_dollar']
+    if shell_indexes:
+        suffix = command[tokens[shell_indexes[0]].start :]
+        try:
+            shell_tokens = tokenize_shell_suffix(suffix)
+        except sqlglot.errors.TokenError as exc:
+            raise PolarsTransformError(f'Unable to parse shell redirection: {exc}') from exc
+        shell_operators = _pipeline_operator_indexes(suffix, shell_tokens)
+        if any(index is not None for index in shell_operators):
+            raise PolarsTransformError('Shell redirections must follow all transform stages.')
     if pipe_index is None and parquet_index is None:
         return None
+    shell_redirect = None
+    if shell_indexes:
+        shell_index = shell_indexes[0]
+        if parquet_index is not None:
+            raise PolarsTransformError('The ".>" operator cannot be combined with shell redirection.')
+        shell_start = tokens[shell_index].start
+        try:
+            shell_redirect = parse_shell_redirect(command[shell_start:])
+        except (ValueError, sqlglot.errors.TokenError) as exc:
+            raise PolarsTransformError(str(exc)) from exc
+        command = command[:shell_start].rstrip()
     if parquet_index is not None and pipe_index is not None and parquet_index < pipe_index:
         raise PolarsTransformError('The ".>" operator must follow the ".|" operator.')
 
@@ -99,6 +122,9 @@ def parse_polars_transform(command: str) -> PolarsPipeline | None:
     else:
         output_mode = 'tabular'
 
+    if shell_redirect is not None and output_mode == 'explorer':
+        raise PolarsTransformError('Explorer output cannot be combined with shell redirection.')
+
     for delimiter in (delimiter_command.current, r'\G', r'\g', r'\x'):
         sql = sql.removesuffix(delimiter).rstrip()
         if expression is not None:
@@ -113,7 +139,13 @@ def parse_polars_transform(command: str) -> PolarsPipeline | None:
             raise PolarsTransformError('File saves require a destination path.')
         output_path = _parse_output_path(output_path)
     _validate_sql(sql)
-    return PolarsPipeline(sql=sql, expression=expression, output_path=output_path, output_mode=output_mode)
+    return PolarsPipeline(
+        sql=sql,
+        expression=expression,
+        output_path=output_path,
+        output_mode=output_mode,
+        shell_redirect=shell_redirect,
+    )
 
 
 def _pipeline_operator_indexes(
@@ -229,6 +261,7 @@ def run_polars_transform(
     plot_scale_factor: float = 1.0,
     plot_ppi: int = 200,
     plot_theme: str = 'carbong90',
+    allow_plots: bool = True,
 ) -> SQLResult:
     iterator = iter(results)
     try:
@@ -298,6 +331,8 @@ def run_polars_transform(
             return SQLResult(status=f'Wrote {len(series_dataframe)} rows to {output_path}.')
         return SQLResult(header=[column_name], rows=[(item,) for item in value])
     elif transform.altair is not None and isinstance(value, transform.altair.TopLevelMixin):
+        if not allow_plots:
+            raise PolarsTransformError('Altair plots cannot use shell redirection. Use ".>" to save a plot file.')
         plot_format = _plot_format_for_path(output_path) if output_path is not None else None
         if output_path is not None and plot_format is None:
             raise PolarsTransformError('Altair plots can only be written to ".png", ".pdf", ".svg", or ".html" files.')