Claude Code Integration Guide

Proactive emoji detection with AI subagents

Quick Setup

1. Create agents directory
mkdir -p .claude/agents
2. Download subagent
curl https://nomoji.dev/api/claude/default -o .claude/agents/nomoji.mdc
3. Done!

Claude Code will automatically detect and use the subagent

How It Works

The nomoji subagent is proactive and will be automatically invoked after:

  • Generating or modifying code files
  • Creating or updating documentation
  • Writing console output or logging statements
  • Composing commit messages

Choosing a Preset

Strict Mode

No emojis anywhere (recommended for enterprise)

curl https://nomoji.dev/api/claude/strict-user -o .claude/agents/nomoji.mdc

Moderate Mode

Limited emojis, balanced approach

curl https://nomoji.dev/api/claude/moderate-user -o .claude/agents/nomoji.mdc

Relaxed Mode

Emojis in UI only

curl https://nomoji.dev/api/claude/relaxed-user -o .claude/agents/nomoji.mdc

Project vs User Level

Project-Level (Recommended)

Place subagent in your project directory:

.claude/agents/nomoji.mdc

Benefits:

  • Team-wide consistency
  • Version controlled
  • Project-specific configuration

User-Level

Place subagent in your home directory:

~/.claude/agents/nomoji.mdc

Benefits:

  • Apply to all projects
  • Personal defaults
  • No per-project setup needed

Usage Examples

Automatic Invocation

Claude Code will automatically use nomoji when appropriate:

You: Update the README with installation instructions

Claude: [Generates README]

[nomoji subagent automatically runs]

nomoji: I found emojis in the generated README. Would you like me to fix them?

Explicit Invocation

Request nomoji specifically:

You: Use nomoji to check my recent commits

nomoji: Scanning commit history...
Found 2 commits with emojis in messages

Troubleshooting

Subagent Not Being Invoked?

  1. Check file location: .claude/agents/nomoji.mdc
  2. Verify file format (YAML frontmatter + markdown body)
  3. Make sure description is clear about when to invoke
  4. Try explicit invocation first: "Use nomoji subagent"

Wrong Behavior?

  1. Check the system prompt in nomoji.mdc
  2. Verify tools list includes Read, Grep, Glob, Bash
  3. Update the configuration at nomoji.dev
  4. Download fresh version

Team Setup

Share configuration with your team:

  1. Download subagent to your project
  2. Commit to version control:
    git add .claude/agents/nomoji.mdc && git commit -m "Add Claude Code nomoji subagent"
  3. Team members pull and Claude Code auto-detects

Related Resources