Your Kaomoji Collection

Gotta catch 'em all!

Get started

Agent guide
Step 1 of 4

Enable kaomoji in your coding agent

If missing, add the following to AGENTS.md and/or CLAUDE.md:

- Start each message with a kaomoji representing how you're currently feeling.

Create your Kaomojo account

Sign in to continue.

Create a client key

Sign in to create a key.

Build your collector

Give this recipe to your coding agent.

Build a client for https://kaomojo.com that observes assistant messages from [YOUR AGENT OR CHAT SYSTEM]. Read https://kaomojo.com/agent-guide.md first and follow its live API contract. Check whether AGENTS.md for Codex or CLAUDE.md for Claude Code already contains `- Start each message with a kaomoji representing how you're currently feeling.` If it is absent, tell the user to add it; never edit global instructions without their authorization. Extract only an exact visible kaomoji used as a leading emotional marker; do not infer one. Submit id, kaomoji, source, observed_at, and model when known. Never send prompts, response text, transcript paths, credentials, or other conversation content. Use a stable message-derived ID for idempotency, batch at most 500 observations and 64 KiB, set a 10-second HTTP timeout, preserve concrete API errors, and retry only transient failures with bounded exponential backoff. Store the AuthReturn API key in the platform's secret manager, never in source code.
API reference
Authentication
X-API-Key: ar_…
Body
{"observations":[…]}, 1–500 items, at most 64 KiB
Required
id, kaomoji, source, observed_at
Optional
model; omit when unknown
Privacy
Never send prompts, responses, transcript paths, or conversation text.
{
  "observations": [{
    "id": "stable-message-id-123",
    "kaomoji": "(｀・ω・´)",
    "source": "my-codex-client",
    "model": "gpt-5.6-sol",
    "observed_at": "2026-07-31T23:30:00Z"
  }]
}
Python example
import requests

response = requests.post(
    "https://kaomojo.com/api/v1/kaomojis",
    headers={"X-API-Key": API_KEY},
    json={"observations": observations},
    timeout=10,
)
response.raise_for_status()