larksuite/cli · error

Args field %s (--%s): %s --%s conflicts with %s flag --%s

Error message

Args field %s (--%s): %s --%s conflicts with %s flag --%s

What it means

Flag-mount plan validation: a typed Args flag (primary name or alias) conflicts with another flag class (host/framework/business) under the same spelling after normalization, including print-schema/flag-name framework introspection aliases.

Source

Thrown at shortcuts/common/typed_flag_collisions.go:66

	}
	if hasFlagSchema {
		aliasConflicts["print-schema"] = "framework complex-input introspection"
		aliasConflicts["flag-name"] = "framework complex-input introspection"
	}

	for _, field := range command.fields {
		if reason, conflict := primaryConflicts[field.name]; conflict {
			return fmt.Errorf("Args field %s (--%s): business flag conflicts with %s flag --%s", field.goName, field.name, reason, field.name)
		}
		for _, alias := range field.cli.Aliases {
			conflicts := primaryConflicts
			kind := "independent alias"
			if alias.Mode == typedAliasNormalize {
				conflicts = aliasConflicts
				kind = "normalize alias"
			}
			if reason, conflict := conflicts[alias.Name]; conflict {
				return fmt.Errorf("Args field %s (--%s): %s --%s conflicts with %s flag --%s", field.goName, field.name, kind, alias.Name, reason, alias.Name)
			}
		}
	}
	return nil
}

View on GitHub (pinned to 7fd6ef3c07)

Solutions

1. Rename the alias away from the framework flag

When it happens

Trigger: Thrown at shortcuts/common/typed_flag_collisions.go:66 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/cf687f6973ea92bd. Report an issue: GitHub.