larksuite/cli · error

Args field %s (--%s) alias --%s conflicts with host %s flag

Error message

Args field %s (--%s) alias --%s conflicts with host %s flag

What it means

Namespace validation: a typed Args flag (or its alias) collides with a reserved host-owned flag name (e.g. profile, yes, jq, help). Shortcut flags must not shadow framework flags.

Source

Thrown at shortcuts/common/typed_external.go:142

		"flag-name":    "schema inspection",
		"format":       "output formatting",
		"help":         "Cobra help",
		"jq":           "output filtering",
		"json":         "JSON output shorthand",
		"page-all":     "pagination",
		"page-delay":   "pagination",
		"page-limit":   "pagination",
		"print-schema": "schema inspection",
		"profile":      "profile selection",
		"yes":          "high-risk confirmation",
	}
	for _, field := range command.fields {
		if role, exists := reserved[field.name]; exists {
			return fmt.Errorf("Args field %s (--%s) conflicts with host %s flag", field.goName, field.name, role)
		}
		for _, alias := range field.cli.Aliases {
			if role, exists := reserved[alias.Name]; exists {
				return fmt.Errorf("Args field %s (--%s) alias --%s conflicts with host %s flag", field.goName, field.name, alias.Name, role)
			}
		}
	}
	return nil
}

View on GitHub (pinned to 7fd6ef3c07)

Solutions

1. Rename the alias to a non-reserved name

When it happens

Trigger: Thrown at shortcuts/common/typed_external.go:142 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of larksuite/cli@7fd6ef3c07 (2026-09-04). Data as JSON: /api/errors/57653927bd88e810. Report an issue: GitHub.