open-index/open-npm huggingface dataset:
npm package: @hypersocial/hypermoji-cli
Description: Hypermoji CLI - Generate animated mascots from the terminal
Latest version: 0.1.17

# @hypersocial/hypermoji-cli

Terminal client for generating Hypermoji mascots and emotes.

## Install

```bash
npm install -g @hypersocial/hypermoji-cli
```

Or run it without a global install:

```bash
npx @hypersocial/hypermoji-cli --help
```

## Login

```bash
hypermoji login
```

This opens the Hypermoji web app in a browser, creates a CLI API key after sign-in, and stores it at `~/.hypermoji/config.json`.
By default, login opens `https://www.hypermoji.com`, unless `HYPERMOJI_WEB_URL` is set.

## Commands

```bash
hypermoji
hypermoji whoami
hypermoji styles list
hypermoji --interactive styles list
hypermoji mascots list
hypermoji mascots list --show-ids
hypermoji mascots create "friendly robot assistant" --wait
hypermoji --interactive mascots create "friendly robot assistant"
hypermoji mascots get <mascot-id>
hypermoji mascots select <mascot-id>
hypermoji emotes batch <mascot-id> "wave hello" "thinking" "celebrating"
hypermoji jobs list
hypermoji jobs wait <job-id>
hypermoji skills verify
hypermoji skills install
```

## Output Modes

- Default: human-friendly summaries and compact tables
- Bare `hypermoji` in a terminal opens the interactive shell for browsing styles, mascots, jobs, and quick actions
- `--json`: structured output for scripts and automation
- `--interactive`: enable prompts where helpful, such as picking a style during mascot creation
- `--show-ids`: available on list commands when you need full resource IDs

## Environment Variables

- `HYPERMOJI_API_KEY`: Use an existing CLI API key instead of the stored config file.
- `HYPERMOJI_API_URL`: Override the default Convex HTTP base URL.
- `HYPERMOJI_WEB_URL`: Override the web app URL used during `hypermoji login`.

## Publishing

From the repo root:

```bash
npm --workspace apps/cli run build
npm publish --workspace apps/cli --access public
```