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 agenda or due items.

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 due item
/create_due_item 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