pick

Single-select menu with keyboard navigation

Quick Start

main.py
python
from connectonion.tui import pick

choice = pick("Pick a color", ["Red", "Green", "Blue"])
# Press 1 → "Red", 2 → "Green", 3 → "Blue"
# Or use arrow keys + Enter
output
Pick a color
 
  ❯ 1  Red
    2  Green
    3  Blue
 
↑↓ navigate  1-9 jump  Enter select

Options

Simple List

main.py
python
choice = pick("Select model", ["gpt-4", "claude-3", "gemini"])
# Returns: "gpt-4" (selected string)

With Descriptions

main.py
python
choice = pick("Send email?", [
    ("Yes, send it", "Send immediately"),
    ("Auto approve", "Skip approval for this recipient"),
    ("No", "Cancel"),
])

With "Other" Option

main.py
python
choice = pick("Continue?", ["Yes", "No"], other=True)
# Adds "Other..." option for custom text input

Keyboard Controls

Key	Action
`↑/↓`	Navigate up/down
`1-9`	Jump to option
`Enter`	Confirm selection
`Esc`	Cancel

API

main.py
python
pick(
    title: str,           # Question to display
    options: list,        # Strings or (label, description) tuples
    other: bool = False,  # Add "Other..." option
    console: Console = None
) -> str                  # Returns selected label

Example Output

Pick a color

  ❯ 1  Red
    2  Green
    3  Blue

↑↓ navigate  1-9 jump  Enter select

pick

Quick Start

Options

Simple List

With Descriptions

With "Other" Option

Keyboard Controls

API

Example Output

Star us on GitHub