{
  "id": "jupytext",
  "name": "Jupytext",
  "homepage": "https://jupytext.readthedocs.io/",
  "description": "Jupyter notebooks as plain text",
  "executables": [
    "jupytext"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/jupytext/",
      "[configHome]/.jupytext*",
      "[configHome]/jupytext*",
      "~/.jupytext*",
      "~/jupytext*"
    ],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Convert or sync notebooks",
    "description": "Convert notebooks between .ipynb and text formats, or synchronize paired files. Piping, linting, kernel and pre-commit options are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "cli",
        "kind": "help",
        "url": "https://github.com/mwouts/jupytext/blob/main/src/jupytext/cli.py",
        "revision": "main 2026-10-27",
        "evidence": "\"notebooks\",\nhelp=\"One or more notebook(s). Notebook is read from stdin when this argument is empty.\",\n\"--from\",\nhelp=\"Jupytext format for the input(s). Inferred from the file extension and content when missing.\",\n\"--to\",\nhelp=( \"The destination format: 'ipynb', 'markdown' or 'script', or a file extension: \"\n\"-o\",\n\"--output\",\nhelp=\"Destination file. Defaults to the original file, \"\n\"--update\",\nhelp=\"Preserve the output cells when the destination notebook is an .ipynb file that already exists\",\n\"--set-formats\",\n\"with e.g. '--set-formats ipynb,py:light'. \"\n\"--sync\",\n\"-s\",\nhelp=\"Synchronize the content of the paired representations of \"\n\"--execute\",\nhelp=\"Execute the notebook with the given kernel.\"\n\"--quiet\",\n\"-q\",\nhelp=\"Quiet mode: do not comment about files being updated or created\",\n\"--show-changes\",\nhelp=\"Display the diff for each output file\",\n"
      }
    ],
    "field": [
      {
        "id": "notebooks",
        "label": "Notebooks",
        "type": "path",
        "position": 0,
        "multiple": true,
        "path": {
          "kind": "file",
          "role": "input",
          "must_exist": true
        },
        "sources": [
          "cli"
        ]
      },
      {
        "id": "from",
        "label": "Input format",
        "description": "Inferred from the file extension when empty.",
        "type": "string",
        "option": [
          "--from"
        ],
        "sources": [
          "cli"
        ]
      },
      {
        "id": "to",
        "label": "Destination format",
        "type": "string",
        "option": [
          "--to"
        ],
        "suggestions": [
          {
            "value": "ipynb",
            "label": "Notebook (ipynb)"
          },
          {
            "value": "markdown",
            "label": "Markdown"
          },
          {
            "value": "script",
            "label": "Script"
          },
          {
            "value": "py:percent",
            "label": "Python percent"
          },
          {
            "value": "md",
            "label": "md"
          }
        ],
        "sources": [
          "cli"
        ]
      },
      {
        "id": "output",
        "label": "Output file",
        "type": "path",
        "option": [
          "--output",
          "-o"
        ],
        "path": {
          "kind": "file",
          "role": "output"
        },
        "effect": "overwrite",
        "sources": [
          "cli"
        ]
      },
      {
        "id": "update",
        "label": "Preserve existing outputs",
        "type": "boolean",
        "option": [
          "--update"
        ],
        "sources": [
          "cli"
        ]
      },
      {
        "id": "set_formats",
        "label": "Set paired formats",
        "description": "For example ipynb,py:light.",
        "type": "string",
        "option": [
          "--set-formats"
        ],
        "sources": [
          "cli"
        ]
      },
      {
        "id": "sync",
        "label": "Sync paired files",
        "type": "boolean",
        "option": [
          "--sync",
          "-s"
        ],
        "effect": "overwrite",
        "sources": [
          "cli"
        ]
      },
      {
        "id": "execute",
        "label": "Execute notebook",
        "type": "boolean",
        "option": [
          "--execute"
        ],
        "effect": "exec",
        "sources": [
          "cli"
        ]
      },
      {
        "id": "show_changes",
        "label": "Show changes",
        "type": "boolean",
        "option": [
          "--show-changes"
        ],
        "sources": [
          "cli"
        ]
      },
      {
        "id": "quiet",
        "label": "Quiet",
        "type": "boolean",
        "option": [
          "--quiet",
          "-q"
        ],
        "sources": [
          "cli"
        ]
      }
    ],
    "task": [
      {
        "id": "to-py",
        "label": "Notebook to percent script",
        "set": {
          "to": [
            "py:percent"
          ]
        },
        "lock": [
          "to"
        ],
        "fields": [
          "notebooks",
          "to",
          "output",
          "quiet"
        ],
        "required": [
          "notebooks"
        ]
      },
      {
        "id": "to-ipynb",
        "label": "Text file to notebook",
        "set": {
          "to": [
            "ipynb"
          ]
        },
        "lock": [
          "to"
        ],
        "fields": [
          "notebooks",
          "to",
          "output",
          "update",
          "execute",
          "quiet"
        ],
        "required": [
          "notebooks"
        ]
      },
      {
        "id": "sync",
        "label": "Sync paired files",
        "set": {
          "sync": [
            true
          ]
        },
        "lock": [
          "sync"
        ],
        "fields": [
          "notebooks",
          "sync",
          "quiet"
        ],
        "required": [
          "notebooks"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "notebooks",
          "from",
          "to",
          "output",
          "sync"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "update",
          "set_formats",
          "execute",
          "show_changes",
          "quiet"
        ]
      }
    ]
  }
}