Configuration Reference¶

Complete reference for all configuration options.

Configuration Files¶

General Settings¶

general.language¶

UI language.

general:
  language: en

general.log_level¶

general:
  log_level: info  # Deprecated, use logging.console_level

general.data_dir¶

Data directory path.

general:
  data_dir: ~/.merlya

Model Settings¶

model.provider¶

LLM provider to use.

model:
  provider: openrouter

model.model¶

Model name/identifier.

model:
  model: amazon/nova-2-lite-v1:free

Provider-specific examples:

model.api_key_env¶

Environment variable name for API key.

model:
  api_key_env: OPENROUTER_API_KEY

model.base_url¶

Custom API endpoint URL (for Ollama or custom providers).

model:
  base_url: http://localhost:11434/v1

Router Settings¶

The router classifies user intent to determine appropriate actions.

router.type¶

Router type for intent classification.

• local: Uses pattern matching for intent classification (fast, no model required)
• llm: Uses LLM for classification (more accurate, requires API)

router:
  type: local

router.llm_fallback¶

LLM model for fallback classification.

router:
  llm_fallback: openrouter:google/gemini-2.0-flash-lite-001

SSH Settings¶

ssh.connect_timeout¶

Connection timeout in seconds.

ssh:
  connect_timeout: 30

ssh.pool_timeout¶

Connection pool timeout in seconds.

ssh:
  pool_timeout: 600

ssh.command_timeout¶

Command execution timeout in seconds.

ssh:
  command_timeout: 60

ssh.default_user¶

Default SSH username.

ssh:
  default_user: deploy

ssh.default_key¶

Default SSH private key path.

ssh:
  default_key: ~/.ssh/id_ed25519

UI Settings¶

ui.theme¶

Color theme.

ui:
  theme: auto

ui.markdown¶

Enable markdown rendering in responses.

ui:
  markdown: true

ui.syntax_highlight¶

Enable syntax highlighting for code blocks.

ui:
  syntax_highlight: true

Logging Settings¶

logging.console_level¶

Console log level for terminal output.

logging:
  console_level: info

logging.file_level¶

File log level.

logging:
  file_level: debug

logging.max_size_mb¶

Maximum log file size in MB before rotation.

logging:
  max_size_mb: 10

logging.max_files¶

Maximum number of log files to keep.

logging:
  max_files: 5

logging.retention_days¶

Log retention in days.

logging:
  retention_days: 7

Hosts Configuration¶

Hosts are stored in a SQLite database and managed via the /hosts commands.

Host Properties¶

Managing Hosts¶

# Add a host
/hosts add web-01

# Import from SSH config
/hosts import ~/.ssh/config --format=ssh

# List hosts
/hosts list

# Show host details
/hosts show web-01

# Add tags
/hosts tag web-01 production

# Delete a host
/hosts delete old-server

Complete Example¶

# ~/.merlya/config.yaml

general:
  language: en

model:
  provider: openrouter
  model: amazon/nova-2-lite-v1:free
  api_key_env: OPENROUTER_API_KEY

router:
  type: local
  tier: balanced
  llm_fallback: openrouter:google/gemini-2.0-flash-lite-001

ssh:
  connect_timeout: 30
  pool_timeout: 600
  command_timeout: 60
  default_user: deploy
  default_key: ~/.ssh/id_ed25519

ui:
  theme: auto
  markdown: true
  syntax_highlight: true

logging:
  console_level: info
  file_level: debug
  max_size_mb: 10
  max_files: 5
  retention_days: 7

Environment Variables¶

Override settings with environment variables: