{
  "id": "render",
  "name": "Render CLI",
  "homepage": "https://render.com/docs/cli",
  "description": "A command-line interface for managing Render resources.",
  "executables": [
    "render"
  ],
  "dotfiles": {
    "paths": [
      "~/.render/cli.yaml"
    ],
    "secret": [],
    "secret_paths": [
      {
        "file": "~/.render/cli.yaml",
        "format": "yaml",
        "match": {
          "key_path": [
            "token"
          ]
        }
      }
    ]
  },
  "commands": {
    "format": 1,
    "label": "Render CLI",
    "description": "View service logs and trigger or list deploys. Other Render commands and the interactive TUI are not covered; --output is added so the commands print plain text or JSON.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "logs"
        ],
        "label": "View logs",
        "description": "Query logs for one or more resources. Resource IDs are required in non-interactive mode.",
        "source": [
          {
            "id": "ref",
            "kind": "manual",
            "url": "https://render.com/docs/cli-reference",
            "revision": "CLI v2.32.0",
            "evidence": "--confirm\nSkip all confirmation prompts\n--output, -o\nSet output format to interactive, json, yaml, or text. Auto-switches to text on non-TTY\n--direction\nSet log query direction (backward or forward)\n--end\nFilter logs at or before the specified end time\n--level\nFilter logs by comma-separated log levels\n--limit\nLimit the number of logs returned\n--resources, -r\nFilter logs by comma-separated resource IDs (Required in non-interactive mode)\n--start\nFilter logs at or after the specified start time\n--tail\nStream new logs\n--text\nFilter logs by comma-separated text values\n--type\nFilter logs by comma-separated log types\n"
          }
        ],
        "field": [
          {
            "id": "resources",
            "label": "Resource IDs",
            "description": "Comma-separated service or datastore IDs.",
            "type": "string",
            "option": [
              "--resources",
              "-r"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "text",
            "label": "Text filter",
            "description": "Comma-separated text values.",
            "type": "string",
            "option": [
              "--text"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "level",
            "label": "Log levels",
            "description": "Comma-separated levels.",
            "type": "string",
            "option": [
              "--level"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "start",
            "label": "Start time",
            "type": "string",
            "option": [
              "--start"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "end",
            "label": "End time",
            "type": "string",
            "option": [
              "--end"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "limit",
            "label": "Limit",
            "type": "integer",
            "option": [
              "--limit"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "direction",
            "label": "Direction",
            "type": "enum",
            "choices": [
              {
                "value": "backward",
                "label": "Backward"
              },
              {
                "value": "forward",
                "label": "Forward"
              }
            ],
            "option": [
              "--direction"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "tail",
            "label": "Stream new logs",
            "type": "boolean",
            "option": [
              "--tail"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "output",
            "label": "Output format",
            "type": "enum",
            "choices": [
              {
                "value": "text",
                "label": "Text"
              },
              {
                "value": "json",
                "label": "JSON"
              },
              {
                "value": "yaml",
                "label": "YAML"
              }
            ],
            "option": [
              "--output",
              "-o"
            ],
            "sources": [
              "ref"
            ]
          }
        ],
        "task": [
          {
            "id": "recent",
            "label": "Recent logs for a resource",
            "fields": [
              "resources",
              "text",
              "level",
              "limit",
              "output"
            ],
            "required": [
              "resources"
            ],
            "set": {
              "output": [
                "text"
              ]
            }
          },
          {
            "id": "stream",
            "label": "Stream logs",
            "fields": [
              "resources",
              "tail",
              "output"
            ],
            "required": [
              "resources",
              "tail"
            ],
            "set": {
              "tail": [
                true
              ]
            }
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "resources",
              "text",
              "level",
              "limit",
              "tail",
              "output"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "start",
              "end",
              "direction"
            ]
          }
        ]
      },
      {
        "path": [
          "deploys",
          "create"
        ],
        "label": "Trigger a deploy",
        "description": "Trigger a service deploy and stream its logs. The service ID may be omitted in interactive use.",
        "source": [
          {
            "id": "ref",
            "kind": "manual",
            "url": "https://render.com/docs/cli-reference",
            "revision": "CLI v2.32.0",
            "evidence": "deploys create [serviceID]\nTrigger a service deploy and stream logs in real time\n--clear-cache\nClear build cache before deploying\n--commit\nDeploy the specified commit ID\n--image\nDeploy the specified Docker image URL\n--wait\nWait for deploy completion and exit non-zero if deploy fails\n--confirm\nSkip all confirmation prompts\n--output, -o\nSet output format to interactive, json, yaml, or text. Auto-switches to text on non-TTY\n"
          }
        ],
        "field": [
          {
            "id": "service_id",
            "label": "Service ID",
            "type": "string",
            "position": 0,
            "sources": [
              "ref"
            ]
          },
          {
            "id": "clear_cache",
            "label": "Clear build cache",
            "type": "boolean",
            "option": [
              "--clear-cache"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "commit",
            "label": "Commit ID",
            "type": "string",
            "option": [
              "--commit"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "image",
            "label": "Docker image URL",
            "type": "string",
            "option": [
              "--image"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "wait",
            "label": "Wait for completion",
            "type": "boolean",
            "option": [
              "--wait"
            ],
            "sources": [
              "ref"
            ]
          },
          {
            "id": "confirm",
            "label": "Skip confirmation prompts",
            "type": "boolean",
            "option": [
              "--confirm"
            ],
            "sources": [
              "ref"
            ]
          }
        ],
        "task": [
          {
            "id": "deploy",
            "label": "Deploy a service",
            "fields": [
              "service_id",
              "clear_cache",
              "wait",
              "confirm"
            ],
            "required": [
              "service_id"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "service_id",
              "clear_cache",
              "commit",
              "image",
              "wait",
              "confirm"
            ]
          }
        ]
      }
    ]
  }
}