nomoji

nomoji.dev

Control emoji usage in AI-generated code, documentation, and output

nomoji.dev is a platform for configuring granular emoji control across AI coding assistants. Stop emojis from cluttering your documentation, console logs, CLI tools, and commit messages.

Why nomoji?

AI coding assistants love emojis. They add them to:

• Documentation headers and markdown files (README, API docs)
• Console output and logging statements
• CLI progress bars and messages
• Code comments and docstrings
• Git commit messages
• Error messages and alerts
• Test output and assertions

While sometimes fun, emojis often:

• Reduce accessibility for screen readers
• Create inconsistent rendering across platforms
• Make text harder to search and parse
• Appear unprofessional in enterprise contexts
• Clutter technical output

nomoji.dev gives you control. Configure exactly where AI assistants can and cannot use emojis.

Features

• Claude Code Subagents: Proactive emoji detection using specialized AI subagents
• Granular Control: Configure emoji rules for documentation, console, CLI, logging, comments, commits, and UI
• Multiple Presets: Strict, moderate, and relaxed configurations
• AI Assistant Integration: Works with Claude Code, Cursor, GitHub Copilot, Google Gemini CLI, and more
• API Access: RESTful API for programmatic access
• Text Analysis: Detect emoji usage in existing code
• Shareable Configs: Share configurations with your team
• Git Hooks: Pre-commit and commit-msg hooks to enforce rules
• Zero Dependencies: Lightweight, running on Cloudflare Workers

Quick Start

Note: Examples use default as the user ID. Replace with your identifier (e.g., my-project, team-alpha). Learn more about user IDs →

Claude Code Users (Recommended)

1. Download the nomoji subagent:

curl https://nomoji.dev/api/claude/default -o nomoji.mdc

2. Place it in your project:

mkdir -p .claude/agents
mv nomoji.mdc .claude/agents/

3. Claude Code will automatically use the subagent to check for emojis!

What it does: The nomoji subagent proactively checks your code after any changes and flags emoji usage with specific recommendations.

Read the full Claude Code integration guide →

Cursor Users

1. Download your rules file:

mkdir -p .cursor/rules
curl https://nomoji.dev/api/cursor-rules/default -o .cursor/rules/nomoji.mdc

2. Cursor will automatically apply the rules

Read the full Cursor integration guide →

GitHub Copilot Users

1. Add to .vscode/settings.json:

{
  "github.copilot.advanced": {
    "customInstructions": "Do not use emojis in code, documentation, console output, CLI tools, logging, or commit messages. Use clear, professional language only."
  }
}

2. Or download full template:

curl https://nomoji.dev/api/template/default/copilot

Read the full GitHub Copilot integration guide →

Google Gemini CLI Users

1. Download and configure:

mkdir -p ~/.gemini
curl https://nomoji.dev/api/template/default/generic -o ~/.gemini/nomoji-rules.md

2. Create config file:

cat > ~/.gemini/config.json << 'EOF'
{
  "systemInstructions": {
    "include": ["~/.gemini/nomoji-rules.md"]
  }
}
EOF

3. Use Gemini CLI normally - it will follow emoji-free guidelines

Read the full Google Gemini CLI integration guide →

OpenAI Codex Users (New!)

1. Install and configure:

# Install Codex CLI (requires ChatGPT Plus/Pro/Business/Edu/Enterprise)
npm i -g @openai/codex

# Download nomoji configuration
curl https://nomoji.dev/api/template/default/openai-codex -o ~/nomoji-codex.md

# Configure system instructions
codex config --system-instructions ~/nomoji-codex.md

2. Use Codex normally - it will generate emoji-free code

What it does: OpenAI Codex is an AI coding agent that works in your terminal and IDE. The nomoji configuration ensures all code generation, documentation, and output is professional and emoji-free.

Also supported: OpenAI API integration and ChatGPT custom instructions (see full guide)

Read the full OpenAI/Codex integration guide →

Git Hooks

Using Lefthook (Recommended)

Lefthook is a fast, cross-platform Git hooks manager that makes it easy to manage and share hooks across your team.

# Install lefthook
npm install --save-dev lefthook

# Download configuration
curl https://nomoji.dev/examples/lefthook.yml -o lefthook.yml

# Install hooks
npx lefthook install

Lefthook automatically:

• Checks for emojis in code and commits
• Runs linting and formatting
• Executes type checking
• Runs tests before pushing

Read the full Lefthook integration guide →

Manual Installation