Skip to content

improvement: always show default value for CLI args (hide if default is None)#8246

Merged
dmadisetti merged 2 commits intomainfrom
ms/always-show-default
Feb 9, 2026
Merged

improvement: always show default value for CLI args (hide if default is None)#8246
dmadisetti merged 2 commits intomainfrom
ms/always-show-default

Conversation

@mscolnick
Copy link
Contributor

@mscolnick mscolnick commented Feb 9, 2026

This cleans up some code without changing the CLI help all that much (and i think including defaults is better).

Examples below:

Usage: marimo edit [OPTIONS] [NAME] [ARGS]...

  Create or edit notebooks.

    * marimo edit               Start the marimo notebook server

    * marimo edit notebook.py   Create or edit notebook.py

Options:
  -p, --port INTEGER              Port to attach to.
  --host TEXT                     Host to attach to.  [default: 127.0.0.1]
  --proxy TEXT                    Address of reverse proxy.
  --headless                      Don't launch a browser.
  --token / --no-token            Use a token for authentication. This enables session-based authentication. A random token will be generated if --token-password is not
                                  set. If --no-token is set, session-based authentication will not be used.   [default: token]
  --token-password TEXT           Use a specific token for authentication. This enables session-based authentication. A random token will be generated if not set.
  --token-password-file TEXT      Path to file containing token password, or '-' for stdin. Mutually exclusive with --token-password.
  --base-url TEXT                 Base URL for the server. Should start with a /.  [default: ""]
  --allow-origins TEXT            Allowed origins for CORS. Can be repeated. Use * for all origins.
  --skip-update-check             Don't check if a new version of marimo is available for download.
  --sandbox / --no-sandbox        Run the notebook in an isolated environment, with dependencies tracked via PEP 723 inline metadata. If already declared, dependencies
                                  will install automatically. Requires uv.
  --trusted / --untrusted         Run notebooks hosted remotely on the host machine; if --untrusted, runs marimo in a Docker container.
  --watch                         Watch the file for changes and reload the code when saved in another editor.
  --skew-protection / --no-skew-protection
                                  Enable skew protection middleware to prevent version mismatch issues.  [default: skew-protection]
  --timeout FLOAT                 Enable a global timeout to shut down the server after specified number of minutes of no connection
  --session-ttl INTEGER           Seconds to wait before closing a session on websocket disconnect. If None is provided, sessions are not automatically closed.
  -h, --help                      Show this message and exit.
  
Usage: marimo edit [OPTIONS] [NAME] [ARGS]...

  Create or edit notebooks.

    * marimo edit               Start the marimo notebook server

    * marimo edit notebook.py   Create or edit notebook.py

Options:
  -p, --port INTEGER              Port to attach to.
  --host TEXT                     Host to attach to.  [default: 127.0.0.1]
  --proxy TEXT                    Address of reverse proxy.
  --headless                      Don't launch a browser.
  --token / --no-token            Use a token for authentication. This enables session-based authentication. A random token will be generated if --token-password is not
                                  set. If --no-token is set, session-based authentication will not be used.   [default: token]
  --token-password TEXT           Use a specific token for authentication. This enables session-based authentication. A random token will be generated if not set.
  --token-password-file TEXT      Path to file containing token password, or '-' for stdin. Mutually exclusive with --token-password.
  --base-url TEXT                 Base URL for the server. Should start with a /.  [default: ""]
  --allow-origins TEXT            Allowed origins for CORS. Can be repeated. Use * for all origins.
  --skip-update-check             Don't check if a new version of marimo is available for download.
  --sandbox / --no-sandbox        Run the notebook in an isolated environment, with dependencies tracked via PEP 723 inline metadata. If already declared, dependencies
                                  will install automatically. Requires uv.
  --trusted / --untrusted         Run notebooks hosted remotely on the host machine; if --untrusted, runs marimo in a Docker container.
  --watch                         Watch the file for changes and reload the code when saved in another editor.
  --skew-protection / --no-skew-protection
                                  Enable skew protection middleware to prevent version mismatch issues.  [default: skew-protection]
  --timeout FLOAT                 Enable a global timeout to shut down the server after specified number of minutes of no connection
  --session-ttl INTEGER           Seconds to wait before closing a session on websocket disconnect. If None is provided, sessions are not automatically closed.
  -h, --help                      Show this message and exit.

@vercel
Copy link

vercel bot commented Feb 9, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
marimo-docs Ready Ready Preview, Comment Feb 9, 2026 10:15pm

Request Review

@dmadisetti dmadisetti merged commit 04e893f into main Feb 9, 2026
49 of 52 checks passed
@dmadisetti dmadisetti deleted the ms/always-show-default branch February 9, 2026 22:36
@github-actions
Copy link

github-actions bot commented Feb 9, 2026

🚀 Development release published. You may be able to view the changes at https://marimo.app?v=0.19.10-dev21

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request merge when ready

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants