@cometchat/skills-cli

CLI for CometChat dashboard authentication + app-credential provisioning.

npx @cometchat/skills-cli@latest auth login

Why this exists

This CLI is a pure dashboard/API client. Its only job is authenticating against the CometChat dashboard and fetching your app credentials (App ID / Region / Auth Key). It knows nothing about UI Kit, React, frameworks, or codegen — the CometChat skills own framework detection, env-file writing, and all code generation. The CLI just gets you authenticated and hands the skills a neutral .cometchat/config.json to build on.

3.0.0 is a breaking re-architecture. Earlier versions (≤2.x) also did framework detection, integration codegen, and .env writing. All of that moved into the skills. Only auth, provision, and config remain.

Commands

| Command | Purpose | |---|---| | cometchat auth <login\|logout\|status\|signup> | Dashboard device-auth. Opens your browser at the CometChat dashboard and stores the bearer token in the OS keychain (falling back to a chmod-600 file). | | cometchat provision <run\|list\|create\|use> | Dashboard app operations. Fetches App ID / Region / Auth Key, prints them as JSON, and writes a neutral .cometchat/config.json. Writes no framework env file. | | cometchat config <init\|get\|set\|show\|path> | Manage .cometchat/config.json — credential/app state only (appId, region, authKey + app metadata). |

All commands accept --json for machine-readable output.

Quick start

# 1. Authenticate against the dashboard (opens your browser)
npx @cometchat/skills-cli@latest auth login

# 2. List the apps on your account
npx @cometchat/skills-cli@latest provision list --json

# 3. End-to-end: pick/create an app, fetch creds, write .cometchat/config.json
npx @cometchat/skills-cli@latest provision run --json

# …or select a specific app by id
npx @cometchat/skills-cli@latest provision use --app-id <id> --json

# 4. Inspect the local config the skills read
npx @cometchat/skills-cli@latest config show --json

What provision writes

provision writes only .cometchat/config.json, a neutral credential/app record:

{
  "version": 1,
  "appId": "…",
  "region": "us",
  "authKey": "…",
  "appName": "My Chat",
  "plan": "…",
  "industry": "…"
}

It does not write any framework env file (.env / VITE_ / NEXT_PUBLIC_ / …) and takes no --framework flag. The skill reads config.json and writes the framework-specific env itself.

License

MIT — © CometChat

Repository

Source + tests live at https://github.com/cometchat/cometchat-skills