# emoji

Emoji utilities: search emoji by name/keyword, look one up by name/shortcode, get random emoji (optionally by group), emojify a sentence (append matching emoji), fetch kaomoji by mood, convert...


Emoji search, suggestion, emojify, kaomoji, shortcodes, and unicode info — pure, zero-dep.

## Tools

| Tool | Args | Returns |
|---|---|---|
| `search` | `{ query, limit? }` | ranked emoji matches |
| `byName` | `{ name }` | one emoji by name/shortcode |
| `random` | `{ count?, group? }` | random emoji |
| `emojify` | `{ text }` | sentence with emoji appended |
| `kaomoji` | `{ mood? }` | a kaomoji (happy/sad/angry/love/shrug/table) |
| `fromShortcode` | `{ shortcode }` | `:smile:` → |
| `toShortcode` | `{ char }` | → `:smile:` |
| `unicodeInfo` | `{ char }` | codepoints + hex |

The emoji table and kaomoji live in `data/emoji.js`.


---
Source: shared/engines/adapters/domain/emoji/README.md
Canonical: https://docs.leumas.tech/p/adapters/domain/emoji