Skip to main content
Version: 0.1.0-alpha.3

Choose and Confirm

Selection and confirmation components for user decisions.

Choose​

Select one or more options from a list.

Basic Usage​

invowk tui choose "Option 1" "Option 2" "Option 3"

Options​

OptionDescription
--titleSelection prompt
--limitMax selections (default: 1)
--no-limitUnlimited selections
--heightList height

Single Selection​

# Basic
COLOR=$(invowk tui choose red green blue)
echo "You chose: $COLOR"

# With title
ENV=$(invowk tui choose --title "Select environment" dev staging prod)

Multiple Selection​

# Limited multi-select (up to 3)
ITEMS=$(invowk tui choose --limit 3 "One" "Two" "Three" "Four" "Five")

# Unlimited multi-select
ITEMS=$(invowk tui choose --no-limit "One" "Two" "Three" "Four" "Five")

Multiple selections are returned as newline-separated values:

SERVICES=$(invowk tui choose --no-limit --title "Select services to deploy" \
    api web worker scheduler)

echo "$SERVICES" | while read -r service; do
    echo "Deploying: $service"
done

Real-World Examples​

Environment Selection​

ENV=$(invowk tui choose --title "Deploy to which environment?" \
    development staging production)

case "$ENV" in
    production)
        if ! invowk tui confirm "Are you sure? This is PRODUCTION!"; then
            exit 1
        fi
        ;;
esac

./deploy.sh "$ENV"

Service Selection​

SERVICES=$(invowk tui choose --no-limit --title "Which services?" \
    api web worker cron)

for service in $SERVICES; do
    echo "Restarting $service..."
    systemctl restart "$service"
done

Confirm​

Yes/no confirmation prompt.

Basic Usage​

invowk tui confirm "Are you sure?"

Returns:

  • Exit code 0 if user confirms (yes)
  • Exit code 1 if user declines (no)

Options​

OptionDescription
--titleTitle displayed above the prompt
--affirmativeCustom "yes" label
--negativeCustom "no" label
--defaultDefault to yes

Examples​

# Basic confirmation
if invowk tui confirm "Continue?"; then
    echo "Continuing..."
else
    echo "Cancelled."
fi

# Custom labels
if invowk tui confirm --affirmative "Delete" --negative "Cancel" "Delete all files?"; then
    rm -rf ./temp/*
fi

# Default to yes (user just presses Enter)
if invowk tui confirm --default "Proceed with defaults?"; then
    echo "Using defaults..."
fi

Conditional Execution​

# Simple pattern
invowk tui confirm "Run tests?" && npm test

# Negation
invowk tui confirm "Skip build?" || npm run build

Dangerous Operations​

# Double confirmation for dangerous actions
if invowk tui confirm "Delete production database?"; then
    echo "This cannot be undone!" | invowk tui style --foreground "#FF0000" --bold
    if invowk tui confirm --affirmative "YES, DELETE IT" --negative "No, abort" "Type to confirm:"; then
        ./scripts/delete-production-db.sh
    fi
fi

In Scripts​

{
    name: "clean"
    description: "Clean build artifacts"
    implementations: [{
        script: """
            echo "This will delete:"
            echo "  - ./build/"
            echo "  - ./dist/"
            echo "  - ./node_modules/"
            
            if invowk tui confirm "Proceed with cleanup?"; then
                rm -rf build/ dist/ node_modules/
                echo "Cleaned!" | invowk tui style --foreground "#00FF00"
            else
                echo "Cancelled."
            fi
            """
        runtimes: [{name: "native"}]
        platforms: [{name: "linux"}, {name: "macos"}]
    }]
}

Combined Patterns​

Selection with Confirmation​

ACTION=$(invowk tui choose --title "Select action" \
    "Deploy to staging" \
    "Deploy to production" \
    "Rollback" \
    "Cancel")

case "$ACTION" in
    "Cancel")
        exit 0
        ;;
    "Deploy to production")
        if ! invowk tui confirm --affirmative "Yes, deploy" "Deploy to PRODUCTION?"; then
            echo "Aborted."
            exit 1
        fi
        ;;
esac

echo "Executing: $ACTION"

Multi-Step Wizard​

# Step 1: Choose action
ACTION=$(invowk tui choose --title "What would you like to do?" \
    "Create new project" \
    "Import existing" \
    "Exit")

if [ "$ACTION" = "Exit" ]; then
    exit 0
fi

# Step 2: Get details
NAME=$(invowk tui input --title "Project name:")

# Step 3: Confirm
echo "Action: $ACTION"
echo "Name: $NAME"

if invowk tui confirm "Create project?"; then
    # proceed
fi

Next Steps​