Cometchat React Native SDK

What it does

When your agent uses it

• The UI Kit has no component for what you need
• Building a fully custom chat UI

Example prompts

• “/cometchat-react-native-sdk”

Requirements

• Node.js
• A credential in AUTH_KEY
• Compatibility (from SKILL.md): React Native >=0.77; @cometchat/chat-sdk-react-native ^4.0.28

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1Dropping the listener cleanup — duplicate messages that grow over time.
2. 2Calling a bare sendMessage() — everything is namespaced under CometChat.
3. 3Inventing sendCardMessage() — card messages are receive-only.
4. 4awaiting startTyping — it returns void.
5. 5Treating getLoggedinUser() returning null as an error — it is the normal no-session answer. (Note the lowercase in.)
6. 6Shipping ban without unban — CometChatGroupMembers shows active members only; wire BannedMembersRequestBuilder + unbanGroupMember too.
7. 7Registering a push token before login resolves — it belongs to no user.

What it can do on your machine

Read from SKILL.md and the folder at commit 911b108. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npm

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • AUTH_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  React Native >=0.77; @cometchat/chat-sdk-react-native ^4.0.28

  From compatibility in the SKILL.md frontmatter.

Context cost

Cometchat React Native SDK loads about 1.8k tokens when it runs, and up to ~8.8k if it reads all its reference files. Until then it costs about 129 tokens; SKILL.md has 689 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~129

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~8.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cometchat/cometchat-skills at commit 911b108, republished under its MIT licence (© cometchat). 689 words, ~1,775 tokens.

name

cometchat-react-native-sdk

description

The headless CometChat Chat SDK for React Native — a method → contract map for the fallback path, plus init/login ordering and listener lifecycle. Use when the UI Kit has no component for what you need, or when building a fully custom chat UI. Triggers: CometChat SDK React Native, headless chat RN, custom chat UI React Native, sendMessage React Native, CometChat listener leak, banned members RN, change my avatar, update my profile, update user details React Native, log the user out.

compatibility

React Native >=0.77; @cometchat/chat-sdk-react-native ^4.0.28

license

MIT

metadata.author

CometChat

metadata.version

1.0.0

metadata.tags

chat cometchat react-native sdk headless methods listeners fallback

npm install @cometchat/chat-sdk-react-native@4 @react-native-async-storage/async-storage@^2.1.2

import { CometChat } from "@cometchat/chat-sdk-react-native";

// DEFAULT via skills: the ai-agent / telemetry-attributed init — persists integrationSource="ai-agent"
// (RULES §Ordering), the SDK sibling of the UI Kit's initFromSettings. Web/JS settings-OBJECT form,
// NOT the classic AppSettingsBuilder + init(APP_ID, settings). initFromSettings is @nodoc (ai-agent-only).
await CometChat.initFromSettings({
  appId: APP_ID,
  region: REGION,
  credentials: { authKey: AUTH_KEY },                        // dev only; prod logs in with an auth token
  chatSDK: { presenceSubscription: { type: "ALL_USERS" } },  // = the old .subscribePresenceForAllUsers()
});
await CometChat.login(UID, AUTH_KEY);   // dev only; production passes an auth token

// FALLBACK only (non-skills / doc-following context) — the publicly-documented classic path:
//   const settings = new CometChat.AppSettingsBuilder()
//     .setRegion(REGION).subscribePresenceForAllUsers().autoEstablishSocketConnection(true).build();
//   await CometChat.init(APP_ID, settings);

useEffect(() => {
  const id = "chat-screen";
  CometChat.addMessageListener(id, new CometChat.MessageListener({
    onTextMessageReceived: (m) => setMessages((prev) => [...prev, m]),
  }));
  return () => CometChat.removeMessageListener(id);   // NOT optional
}, []);

© cometchat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/cometchat-react-native-sdk of cometchat/cometchat-skills.

• SKILL.md
• references/method-map.md
• references/page-map.md

Open the folder on GitHubat commit 911b108