Terminal

Interactive terminal utilities: selection menus, yes/no prompts, and inline autocomplete.

Usage

Option 1: Import directly

main.py
python
from connectonion import pick, yes_no, autocomplete

Option 2: Copy and customize

code

bash

co copy terminal

main.py
python
from tools.terminal import pick, yes_no, autocomplete  # Your local copy

Quick Start

main.py
python
from connectonion import pick, yes_no, autocomplete

# Selection menu
choice = pick("Pick a color", ["Red", "Green", "Blue"])

# Yes/No confirmation
ok = yes_no("Are you sure?")

# Inline autocomplete dropdown (you supply the candidates)
files = ["agent.py", "main.py", "utils.py"]
selected = autocomplete(files)
if selected:
    print(f"Selected: {selected}")

Want to customize? Run co copy terminal to get an editable copy.

pick()

Single-select menu with keyboard navigation.

main.py
python
# List options (press 1, 2, 3 or arrow keys)
choice = pick("Apply this command?", [
    "Yes, apply",
    "Yes for same command",
    "No, tell agent how"
])

# Dict options (returns key)
choice = pick("Continue?", {
    "y": "Yes, continue",
    "n": "No, cancel",
})

yes_no()

Simple binary confirmation.

main.py
python
ok = yes_no("Delete this file?")
# Press y → True, n → False

autocomplete()

Inline dropdown with arrow-key navigation over a list you provide. It's a pure UI component — filtering/search is up to the caller.

main.py
python
selected = autocomplete(["agent.py", "main.py", "utils.py"], max_visible=5)
# Arrow keys to navigate, Enter to select
# Returns the chosen string, or None if cancelled (Esc)

Pair it with connectonion.tui.Input for a text field with built-in @-triggered file autocomplete.

Keyboard Controls

Key	Action
↑/↓	Navigate options (pick, autocomplete)
1-9 / letters	Quick select by key (pick, list or dict options)
Enter	Confirm selection
Esc	Cancel (autocomplete only — pick() has no Esc handler, use Ctrl+C)
Ctrl+C / Ctrl+D	Cancel with KeyboardInterrupt (pick, yes_no)
y / n	Answer directly (yes_no)

Customizing

Need to modify terminal utilities? Copy the source to your project:

code

bash

co copy terminal

Then import from your local copy:

main.py
python
# from connectonion import pick, yes_no  # Before
from tools.terminal import pick, yes_no   # After - customize freely!

Useful Tools

Slash Command