{
  "id": "baguette",
  "name": "Baguette",
  "homepage": "https://tddworks.github.io/baguette/",
  "description": "Headless iOS Simulator manager and host-side input injection for iOS 26.",
  "executables": [
    "baguette"
  ],
  "platforms": [
    "macos"
  ],
  "dotfiles": {
    "paths": [
      "~/.baguette/bakeries.json",
      "~/.baguette/installed.json"
    ],
    "exclude": [
      "~/.baguette/bakeries/",
      "~/.baguette/plugins/"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Baguette simulator tools",
    "description": "Boot a headless simulator, capture screenshots and recordings, and tail its log. Input injection (tap, swipe, type), location, network and plugin commands are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "boot"
        ],
        "label": "Boot a simulator",
        "source": [
          {
            "id": "ref",
            "kind": "help",
            "url": "https://github.com/tddworks/baguette/blob/main/docs/commands.md",
            "revision": "2026-10-27",
            "evidence": "baguette boot --udid <udid> [--no-heal]\n| `--udid` | yes |  | Simulator UDID |\n| `--no-heal` |  |  | Leave the input surface alone even if Xcode 27's Device Hub has shadowed it (see `baguette heal`). |\n"
          }
        ],
        "field": [
          {
            "id": "udid",
            "label": "Simulator UDID",
            "type": "string",
            "option": [
              "--udid"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "no_heal",
            "label": "Do not heal the input surface",
            "type": "boolean",
            "option": [
              "--no-heal"
            ],
            "sources": [
              "ref"
            ]
          }
        ],
        "task": [
          {
            "id": "boot",
            "label": "Boot headlessly",
            "fields": [
              "udid",
              "no_heal"
            ],
            "required": [
              "udid"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "udid",
              "no_heal"
            ]
          }
        ]
      },
      {
        "path": [
          "screenshot"
        ],
        "label": "Take a screenshot",
        "source": [
          {
            "id": "ref",
            "kind": "help",
            "url": "https://github.com/tddworks/baguette/blob/main/docs/commands.md",
            "revision": "2026-10-27",
            "evidence": "baguette screenshot --udid <udid> [--output <output>] [--metadata-output <metadata-output>] [--quality <quality>] [--scale <scale>] [--size <size>] [--fit <fit>] [--background <background>] [--format <format>] [--display <display>]\n| `--udid` | yes |  | Simulator UDID |\n| `--output` |  |  | Output file (defaults to stdout) |\n| `--quality` |  | `0.85` | JPEG quality (0.0 – 1.0); ignored for PNG |\n| `--size` |  | `native` | Output size: WIDTHxHEIGHT, W:H, or one of: native \\| appstore-6.9 \\| appstore-6.5 \\| appstore-ipad-13 \\| square \\| 16:9 \\| 9:16 \\| 4:3 \\| 4:5 |\n| `--fit` |  | `contain` | How the frame fills the size: contain, cover, stretch |\n| `--background` |  | `#ffffff` | Letterbox background: transparent or #RRGGBB |\n| `--format` |  |  | Image format: png \\| jpg (defaults to the --output extension, else jpg) |\n| `--display` |  |  | Target display plane: phone \\| carplay |\n"
          }
        ],
        "field": [
          {
            "id": "udid",
            "label": "Simulator UDID",
            "type": "string",
            "option": [
              "--udid"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "output",
            "label": "Output file",
            "description": "Defaults to stdout.",
            "type": "path",
            "option": [
              "--output"
            ],
            "path": {
              "kind": "file",
              "role": "output"
            },
            "effect": "overwrite",
            "sources": [
              "ref"
            ]
          },
          {
            "id": "size",
            "label": "Output size",
            "description": "WIDTHxHEIGHT, W:H, or a preset.",
            "type": "string",
            "option": [
              "--size"
            ],
            "suggestions": [
              {
                "value": "native",
                "label": "Native"
              },
              {
                "value": "appstore-6.9",
                "label": "App Store 6.9 inch"
              },
              {
                "value": "appstore-6.5",
                "label": "App Store 6.5 inch"
              },
              {
                "value": "appstore-ipad-13",
                "label": "App Store iPad 13 inch"
              },
              {
                "value": "square",
                "label": "Square"
              }
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "fit",
            "label": "Fit",
            "type": "enum",
            "option": [
              "--fit"
            ],
            "choices": [
              {
                "value": "contain",
                "label": "Contain"
              },
              {
                "value": "cover",
                "label": "Cover"
              },
              {
                "value": "stretch",
                "label": "Stretch"
              }
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "format",
            "label": "Image format",
            "type": "enum",
            "option": [
              "--format"
            ],
            "choices": [
              {
                "value": "png",
                "label": "PNG"
              },
              {
                "value": "jpg",
                "label": "JPEG"
              }
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "quality",
            "label": "JPEG quality",
            "description": "0.0 to 1.0; ignored for PNG.",
            "type": "number",
            "option": [
              "--quality"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "background",
            "label": "Letterbox background",
            "description": "transparent or #RRGGBB.",
            "type": "string",
            "option": [
              "--background"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "display",
            "label": "Display",
            "type": "enum",
            "option": [
              "--display"
            ],
            "choices": [
              {
                "value": "phone",
                "label": "Phone"
              },
              {
                "value": "carplay",
                "label": "CarPlay"
              }
            ],
            "sources": [
              "ref"
            ]
          }
        ],
        "task": [
          {
            "id": "shot",
            "label": "Screenshot to a file",
            "fields": [
              "udid",
              "output",
              "size",
              "format"
            ],
            "required": [
              "udid",
              "output"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "udid",
              "output",
              "size",
              "format"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "fit",
              "quality",
              "background",
              "display"
            ]
          }
        ]
      },
      {
        "path": [
          "record"
        ],
        "label": "Record the screen",
        "source": [
          {
            "id": "ref",
            "kind": "help",
            "url": "https://github.com/tddworks/baguette/blob/main/docs/commands.md",
            "revision": "2026-10-27",
            "evidence": "baguette record --udid <udid> --output <output> [--size <size>] [--fit <fit>] [--background <background>] [--fps <fps>] [--duration <duration>] [--bitrate <bitrate>]\n| `--udid` | yes |  | Simulator UDID |\n| `--output` | yes |  | Output video file — .mp4 or .mov |\n| `--size` |  | `native` | Output size: native \\| appstore-6.9 \\| appstore-6.5 \\| appstore-ipad-13 \\| square \\| 16:9 \\| 9:16 \\| 4:3 \\| 4:5, WIDTHxHEIGHT, or W:H |\n| `--fit` |  | `contain` | Frame placement: contain \\| cover \\| stretch |\n| `--fps` |  | `30` | Frames per second (1 – 120) |\n| `--duration` |  |  | Stop N seconds after launch (omit to record until Ctrl-C) |\n| `--bitrate` |  | `8000000` | H.264 average bitrate (bps) |\n"
          }
        ],
        "field": [
          {
            "id": "udid",
            "label": "Simulator UDID",
            "type": "string",
            "option": [
              "--udid"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "output",
            "label": "Output video file",
            "description": ".mp4 or .mov",
            "type": "path",
            "option": [
              "--output"
            ],
            "path": {
              "kind": "file",
              "role": "output"
            },
            "effect": "overwrite",
            "sources": [
              "ref"
            ]
          },
          {
            "id": "size",
            "label": "Output size",
            "type": "string",
            "option": [
              "--size"
            ],
            "suggestions": [
              {
                "value": "native",
                "label": "Native"
              },
              {
                "value": "appstore-6.9",
                "label": "App Store 6.9 inch"
              },
              {
                "value": "appstore-6.5",
                "label": "App Store 6.5 inch"
              },
              {
                "value": "appstore-ipad-13",
                "label": "App Store iPad 13 inch"
              },
              {
                "value": "square",
                "label": "Square"
              }
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "fit",
            "label": "Fit",
            "type": "enum",
            "option": [
              "--fit"
            ],
            "choices": [
              {
                "value": "contain",
                "label": "Contain"
              },
              {
                "value": "cover",
                "label": "Cover"
              },
              {
                "value": "stretch",
                "label": "Stretch"
              }
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "fps",
            "label": "Frames per second",
            "type": "integer",
            "option": [
              "--fps"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "duration",
            "label": "Duration (seconds)",
            "description": "Omit to record until Ctrl-C.",
            "type": "number",
            "option": [
              "--duration"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "bitrate",
            "label": "Bitrate (bps)",
            "type": "integer",
            "option": [
              "--bitrate"
            ],
            "sources": [
              "ref"
            ]
          }
        ],
        "task": [
          {
            "id": "clip",
            "label": "Record a timed clip",
            "fields": [
              "udid",
              "output",
              "size",
              "duration"
            ],
            "required": [
              "udid",
              "output"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "udid",
              "output",
              "size",
              "duration"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "fit",
              "fps",
              "bitrate"
            ]
          }
        ]
      },
      {
        "path": [
          "logs"
        ],
        "label": "Stream the log",
        "source": [
          {
            "id": "ref",
            "kind": "help",
            "url": "https://github.com/tddworks/baguette/blob/main/docs/commands.md",
            "revision": "2026-10-27",
            "evidence": "baguette logs --udid <udid> [--level <level>] [--style <style>] [--predicate <predicate>] [--bundle-id <bundle-id>]\n| `--udid` | yes |  | Simulator UDID |\n| `--level` |  | `info` | Minimum log level: default \\| info \\| debug |\n| `--style` |  | `default` | Output style: default \\| compact \\| json \\| syslog \\| ndjson |\n| `--predicate` |  |  | NSPredicate string passed to `log stream --predicate` verbatim |\n| `--bundle-id` |  |  | Convenience: filter to a specific process by bundle / image name. ANDs with --predicate when both given. |\n"
          }
        ],
        "field": [
          {
            "id": "udid",
            "label": "Simulator UDID",
            "type": "string",
            "option": [
              "--udid"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "level",
            "label": "Minimum level",
            "type": "enum",
            "option": [
              "--level"
            ],
            "choices": [
              {
                "value": "default",
                "label": "Default"
              },
              {
                "value": "info",
                "label": "Info"
              },
              {
                "value": "debug",
                "label": "Debug"
              }
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "style",
            "label": "Output style",
            "type": "enum",
            "option": [
              "--style"
            ],
            "choices": [
              {
                "value": "default",
                "label": "Default"
              },
              {
                "value": "compact",
                "label": "Compact"
              },
              {
                "value": "json",
                "label": "JSON"
              },
              {
                "value": "syslog",
                "label": "Syslog"
              },
              {
                "value": "ndjson",
                "label": "NDJSON"
              }
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "predicate",
            "label": "NSPredicate filter",
            "type": "string",
            "option": [
              "--predicate"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "bundle_id",
            "label": "Bundle id",
            "type": "string",
            "option": [
              "--bundle-id"
            ],
            "sources": [
              "ref"
            ]
          }
        ],
        "task": [
          {
            "id": "app_logs",
            "label": "Logs for one app",
            "fields": [
              "udid",
              "bundle_id",
              "level"
            ],
            "required": [
              "udid",
              "bundle_id"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "udid",
              "bundle_id",
              "level"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "style",
              "predicate"
            ]
          }
        ]
      }
    ]
  }
}