CLI¶

Elroy provides a terminal UI (TUI) for interacting with the AI assistant directly from your terminal.

Starting Elroy¶

# Open the interactive chat interface
elroy

This opens a full-screen terminal application where you can chat with the assistant, create memories, and manage reminders.

Slash Commands¶

Inside the chat interface, Elroy supports slash commands for quick actions:

# Create a memory
/create_memory This is important information I want to save

# Create a reminder
/create_reminder Learn how to use Elroy effectively

# List memories
/print_memories

# Search memories
/search_memories project notes

# Show configuration
/print_config

# See all available commands
/help

For a full list of available tools and slash commands, see the Tools Guide.

Keyboard Shortcuts¶

Key	Action
`Ctrl+D`	Exit
`Ctrl+C`	Cancel current response
`F2`	Toggle memory panel

Configuration¶

Elroy is configured via environment variables or a config file — there are no command-line flags. See the Configuration Guide for details.

# Use a specific model
ELROY_CHAT_MODEL=claude-sonnet-4-5-20250929 elroy

# Use a custom config file
ELROY_CONFIG_PATH=~/my-elroy-config.yaml elroy

Document Ingestion¶

To ingest documents into Elroy's memory, use the /ingest_doc slash command inside the chat interface, or configure background ingestion via the config file:

# ~/.elroy/elroy.conf.yaml
background_ingest_enabled: true
background_ingest_paths:
  - ~/documents/
background_ingest_interval_minutes: 60