A lightweight, standalone module for creating interactive command-line menus in R, inspired by:

• inquirer.js (JavaScript)
• pick (Python)
• survey (Go)

• Single selection - Select one item from a list
• Multiple selection - Select multiple items with checkboxes
• Keyboard navigation - Arrow keys or vi-style (j/k) navigation
• Scrollable menus - Automatic pagination for long lists
• Select all - Optional toggle to select/deselect all items at once
• Pre-selection support - Start with items already selected
• Return flexibility - Return values or indices
• Minimal dependencies - Only requires the cli package

install.packages("climenu")

library(climenu)

colors <- c("Red", "Green", "Blue", "Yellow", "Purple")
selected <- menu(colors, prompt = "Choose your favorite color:")
# User navigates with ↑↓ or j/k, presses Enter to select
# Returns: "Blue" (for example)

library(climenu)

toppings <- c("Pepperoni", "Mushrooms", "Olives", "Onions", "Extra Cheese")
selected <- menu(
  toppings,
  type = "checkbox",
  prompt = "Select pizza toppings:"
)
# User navigates with ↑↓, toggles with Space, confirms with Enter
# Returns: c("Pepperoni", "Extra Cheese", "Mushrooms")

library(climenu)

# Pre-select by value
selected <- checkbox(
  choices = c("Option A", "Option B", "Option C"),
  selected = c("Option A", "Option C")
)

# Pre-select by index
selected <- checkbox(
  choices = c("Option A", "Option B", "Option C"),
  selected = c(1, 3),
  return_index = TRUE
)
# Returns: c(1, 2, 3) if user adds Option B

library(climenu)

# Single selection
choice <- select(c("Yes", "No", "Maybe"))

# Multiple selection
choices <- checkbox(c("Item 1", "Item 2", "Item 3"))

On terminals that don't support single-key input (e.g. RStudio or RGui on Windows), climenu falls back to a numbered-prompt mode — type the number of your choice (or comma-separated numbers for checkboxes) and press Enter.

Main entry point for creating menus.

Parameters:

• choices - Character vector of options
• prompt - Message to display (default: "Select an item:")
• type - "select" for single, "checkbox" for multiple (default: "select")
• selected - Pre-selected items (indices or values)
• return_index - Return indices instead of values (default: FALSE)

Returns: Selected value(s) or NULL if cancelled

Single selection menu. Same parameters as menu() (without type), plus:

• max_visible - Maximum items to display at once (default: 10). Set to NULL to show all.

Multiple selection menu with checkboxes. Same parameters as menu() (without type), plus:

• max_visible - Maximum items to display at once (default: 10). Set to NULL to show all.
• allow_select_all - Add a "Select all" / "Deselect all" toggle at the top (default: FALSE).

# Install dependencies
make deps

# Run tests
make test

# Lint code
make lint

# Run all checks
make all

See CONTRIBUTING.md for detailed development guidelines.

make help          # Show all available commands
make install       # Install package locally
make test          # Run test suite
make check         # Run R CMD check
make lint          # Lint code
make document      # Generate documentation
make build         # Build source package
make coverage      # Generate test coverage report
make clean         # Remove build artifacts
make all           # Run all quality checks

1. Lightweight - Minimal dependencies (only cli)
2. Intuitive - Familiar keyboard controls from other CLI tools
3. Flexible - Works as a standalone package or integrated into other packages
4. Robust - Graceful fallback for non-interactive environments

• Autocomplete/search filtering
• Nested menus
• Custom styling/themes
• Input validation prompts
• Password prompts
• Progress bars

When not running in an interactive R session, the menu functions:

• Issue a warning
• Return the first choice (select) or pre-selected items (checkbox)
• Do not block execution