Skip to content

[plan] Enhance interactive workflow builder with huh v0.7.0+ features #7216

@github-actions

Description

@github-actions

Overview

This tracking issue covers improvements to the interactive workflow creation wizard (pkg/cli/interactive.go) based on the comprehensive review of the charmbracelet/huh library.

Source: Discussion #7214

gh-aw is already on the latest version (v0.8.0), but we're not leveraging several powerful features introduced in v0.7.0+ that would significantly improve the user experience.

Current Status

Strengths:

  • Proper accessibility mode detection
  • Custom validation with clear error messages
  • Autocomplete suggestions for workflow names
  • Clean, well-organized code structure

⚠️ Missing Opportunities:

  • Not using dynamic forms features (v0.7.0+)
  • No group titles/descriptions for visual organization
  • No file overwrite confirmation dialog
  • Validation functions are inline (not testable)

Planned Tasks

This work is organized into quick wins that can be implemented independently:

  1. Add Confirm field for file overwrite - Replace error with interactive confirmation (~5 min)
  2. Extract validation functions - Make validation testable and reusable (~15 min)
  3. Add group titles and descriptions - Improve form navigation and clarity (~10 min)
  4. Enhance accessibility detection - Add ACCESSIBLE env var per best practices (~2 min)
  5. Add spinner integration - Show progress during workflow compilation (~30 min)

Success Criteria

  • Users get interactive confirmation instead of errors when files exist
  • Validation logic is testable and maintainable
  • Form sections are clearly organized with titles
  • Accessibility mode works with ACCESSIBLE environment variable
  • Compilation shows progress feedback

Impact

Total Effort: ~1 hour
User Experience: Significantly improved professional-grade interactive experience
Code Quality: Better maintainability and testability

Related

AI generated by Plan Command for discussion #7214

Sub-issues

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions