gastownhall/beads · info

title is required

Error message

title is required

What it means

Inline huh form validation error: the Title field's Validate function rejects an empty or whitespace-only title. The form re-displays the field so the user can enter a value.

Source

Thrown at cmd/bd/create_form.go:284

	priorityOptions := []huh.Option[string]{
		huh.NewOption("P0 - Critical", "0"),
		huh.NewOption("P1 - High", "1"),
		huh.NewOption("P2 - Medium (default)", "2"),
		huh.NewOption("P3 - Low", "3"),
		huh.NewOption("P4 - Backlog", "4"),
	}

	// Build the form
	form := huh.NewForm(
		huh.NewGroup(
			huh.NewInput().
				Title("Title").
				Description("Brief summary of the issue (required)").
				Placeholder("e.g., Fix authentication bug in login handler").
				Value(&raw.Title).
				Validate(func(s string) error {
					if strings.TrimSpace(s) == "" {
						return fmt.Errorf("title is required")
					}
					if len(s) > 500 {
						return fmt.Errorf("title must be 500 characters or less")
					}
					return nil
				}),

			huh.NewText().
				Title("Description").
				Description("Detailed context about the issue").
				Placeholder("Explain why this issue exists and what needs to be done...").
				CharLimit(5000).
				Value(&raw.Description),

			huh.NewSelect[string]().
				Title("Type").
				Description("Categorize the kind of work").
				Options(typeOptions...).

View on GitHub (pinned to 71377f2769)

Solutions

1. Type a non-empty title and resubmit the field
2. Trim accidental whitespace from pasted input
3. Use non-interactive `bd create "Title"` instead of the form

if strings.TrimSpace(title) == "" { return errors.New("title is required") }

When it happens

Trigger: User (or a scripted form driver) submits the interactive `bd create` form with an empty Title, or only whitespace.

Common situations: Pressing Enter through the form quickly; pasting a clipboard value that is whitespace; automation feeding blank input.

Related errors

• title must be 500 characters or less
• ErrFieldTooLong
• close: id must not be empty
• close: actor must not be empty
• add labels: id must not be empty

AI-assisted analysis of gastownhall/beads@71377f2769 (2026-08-30). Data as JSON: /api/errors/b3c6770034eed2aa. Report an issue: GitHub.