CLI

Elroy provides a powerful command-line interface that makes it easy to interact with the AI assistant directly from your terminal.

Basic Usage

# Start the chat interface
elroy chat

# Or just 'elroy' which defaults to chat mode
elroy

# Process a single message and exit
elroy message "Say hello world"

# Create a memory
elroy remember "This is important information I want to save"

Slash Commands

Elroy supports powerful slash commands for quick actions:

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

# Create a goal
/create_goal Learn how to use Elroy effectively

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

Command Reference

Command	Description
elroy chat	Opens an interactive chat session (default command)
elroy message TEXT	Process a single message and exit
elroy remember [TEXT]	Create a new memory from text or interactively
elroy list-models	Lists supported chat models and exits
elroy list-tools	Lists all available tools
elroy print-config	Shows current configuration and exits
elroy version	Show version and exit
elroy print-tool-schemas	Prints the schema for a tool and exits
elroy set-persona TEXT	Set a custom persona for the assistant
elroy reset-persona	Removes any custom persona, reverting to the default
elroy show-persona	Print the system persona and exit
elroy mcp	MCP server commands

Shell Integration

Elroy can be used in scripts and automated workflows:

# Process a single question
echo "What is 2+2?" | elroy chat

# Create a memory from file content
cat meeting_notes.txt | elroy remember

# Use a specific tool with piped input
echo "Buy groceries" | elroy message --tool create_goal

For more detailed information about configuration options and flags, see the Configuration page.