Emoji Filter Configuration Guide

Overview

The emoji filter system helps maintain professional, emoji-free code by filtering emojis from LLM responses and preventing them from being written to your files.

Configuration Methods

1. Session Configuration (Temporary)

Use the /set command to configure for the current session:

# Set to auto mode (default - filters silently)
/set emojifilter auto

# Set to warn mode (filters with feedback)
/set emojifilter warn

# Set to error mode (blocks content with emojis)
/set emojifilter error

# Set to allowed mode (no filtering)
/set emojifilter allowed

# Remove session override (revert to default)
/set unset emojifilter

2. Default Configuration (Persistent)

Add to your ~/.llxprt/settings.json file:

{
  "emojiFilter": {
    "mode": "auto"
  },
  "providers": {
    // ... your provider configs
  }
}

3. Profile Configuration

Save your current configuration to a profile:

# Set your preferred mode
/set emojifilter warn

# Save to profile
/profile save myprofile

# Later, load the profile
/profile load myprofile

Configuration Hierarchy

Settings are applied in this order (highest priority first):

  1. Session - Set via /set emojifilter command
  2. Profile - Loaded via /profile load
  3. Default - From settings.json
  4. Built-in - auto mode if nothing configured

Filter Modes

allowed - No Filtering

  • Emojis pass through unchanged
  • No warnings or errors
  • Use when you want emojis in responses

auto - Silent Filtering (Default)

  • Converts functional emojis to text (✅ → [OK])
  • Removes decorative emojis (🎉, 😀)
  • No feedback messages
  • Requirement REQ-004.1 compliant

warn - Filter with Feedback

  • Same filtering as auto mode
  • Provides feedback when emojis are filtered
  • Shows system reminder messages
  • Good for understanding what's being filtered

error - Block Emoji Content

  • Prevents any content with emojis
  • Blocks file operations if emojis detected
  • Returns error messages
  • Maximum protection for code files

What Gets Filtered

Filtered (File Modification Tools)

  • edit - File editing operations
  • write_file - File creation/writing
  • Tool arguments for file operations

NOT Filtered (Search/Read Tools)

  • grep, glob, find, ls - Search operations
  • bash, shell - Shell commands
  • read_file - File reading
  • File paths (even with emojis)
  • User input

Examples

Example settings.json

{
  "emojiFilter": {
    "mode": "warn"
  },
  "providers": {
    "anthropic": {
      "enabled": true,
      "apiKey": "your-key",
      "model": "claude-3-opus-20240229"
    }
  },
  "ui": {
    "theme": "dark"
  }
}

Common Emoji Conversions

Emoji Converted To
✅ [OK]
✓ [OK]
❌ [ERROR]
⚠️ WARNING:
💡 TIP:
📝 NOTE:
⚡ [ACTION]

Decorative Emojis Removed

These emojis are removed entirely:

  • 🎉 🎊 ✨ 💫 ⭐ 🌟
  • 😀 😃 😄 😁 😊 😎
  • 👍 👎 👏 🙌 💪
  • 🔥 💯 🚀 💥

Troubleshooting

Emojis Still Appearing?

  1. Check current mode: The mode is shown when you use /set emojifilter
  2. Verify no session override: Use /set unset emojifilter to clear
  3. Check your settings.json for typos

Want to Search for Emojis?

Search tools are not filtered, so you can:

# This works - search tools aren't filtered
grep "🎉" myfile.txt

File with Emoji in Name?

File paths are preserved:

# This works - file paths aren't filtered
/edit "my-file-🎉.txt"

Requirements Compliance

  • REQ-003.1: Session-level configuration via /set command ✅
  • REQ-003.2: Default configuration in settings.json ✅
  • REQ-003.3: Profile support for saving configurations ✅
  • REQ-003.4: Configuration hierarchy (Session > Profile > Default) ✅
  • REQ-004.1: Silent filtering in auto mode ✅
  • REQ-004.2: Post-execution feedback in warn mode ✅
  • REQ-004.3: Block execution in error mode ✅
  • REQ-005: Search tool exclusions ✅