{"_id":"@animocabrands/minds-cli","_rev":"8-29f079313dfbaf954df4ab0141d54fb8","name":"@animocabrands/minds-cli","dist-tags":{"beta":"0.1.1","latest":"0.1.4"},"versions":{"0.1.0":{"name":"@animocabrands/minds-cli","version":"0.1.0","license":"UNLICENSED","_id":"@animocabrands/minds-cli@0.1.0","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"bin":{"minds":"dist/cli.js"},"dist":{"shasum":"d48096fa208d8ff172b53d91248d4929f2213985","tarball":"https://registry.npmjs.org/@animocabrands/minds-cli/-/minds-cli-0.1.0.tgz","fileCount":3,"integrity":"sha512-AOZFu9l4gNNKcMsSDK9b4lQ0vcWnkrQY2yoxaTgvJ5303h1BQ8DnhU0IUD2EfN53mas/yOEdvKHrXpLtCAH9Hg==","signatures":[{"sig":"MEQCIFdY03x+/bWSUh/O5vcKJHGdq8edsgAfrBR9+crDocyoAiBlSPmnlSXw2ClJxPvzmFWk02UP0K+J/rEMUq4u5KBy1Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":82792},"type":"module","_from":"file:animocabrands-minds-cli-0.1.0.tgz","engines":{"node":">=22"},"scripts":{"lint":"eslint src","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/74d8bccf5019490b1d64e364eeba8836/animocabrands-minds-cli-0.1.0.tgz","_integrity":"sha512-AOZFu9l4gNNKcMsSDK9b4lQ0vcWnkrQY2yoxaTgvJ5303h1BQ8DnhU0IUD2EfN53mas/yOEdvKHrXpLtCAH9Hg==","_npmVersion":"11.12.1","description":"Agent-first CLI for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","dependencies":{"commander":"^13.1.0","@animocabrands/minds-client-lib":"0.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-cli_0.1.0_1780998517988_0.661584270103653","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@animocabrands/minds-cli","version":"0.1.1","license":"UNLICENSED","_id":"@animocabrands/minds-cli@0.1.1","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"bin":{"minds":"dist/cli.js"},"dist":{"shasum":"5e5f5e9d7e3905159f1a2ab48efe3c743139a8e9","tarball":"https://registry.npmjs.org/@animocabrands/minds-cli/-/minds-cli-0.1.1.tgz","fileCount":4,"integrity":"sha512-+vrjZTPdzhm1Yk0pywQo7EP5ulvwSQ/X/Ikww27XySOvKIosO/1Pt1Sm8KdstbRx71Bb/lxpvCo519wQp1Xj7Q==","signatures":[{"sig":"MEUCIG9iCtFl9rSeKNGxnU8ySwdrup0F5lO/Q7YVQUpI9oIiAiEA0fyQQTfWqotuvag4wnsqNAj6HwD27M954jl4vIgngzY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":174200},"type":"module","_from":"file:animocabrands-minds-cli-0.1.1.tgz","engines":{"node":">=22"},"scripts":{"lint":"eslint src","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/f29cfb60f382a740534626587f25a1de/animocabrands-minds-cli-0.1.1.tgz","_integrity":"sha512-+vrjZTPdzhm1Yk0pywQo7EP5ulvwSQ/X/Ikww27XySOvKIosO/1Pt1Sm8KdstbRx71Bb/lxpvCo519wQp1Xj7Q==","_npmVersion":"11.12.1","description":"Agent-first CLI for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","dependencies":{"commander":"^13.1.0","@animocabrands/minds-client-lib":"0.1.1"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-cli_0.1.1_1782408348863_0.05862336240227983","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@animocabrands/minds-cli","version":"0.1.2","license":"UNLICENSED","_id":"@animocabrands/minds-cli@0.1.2","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"bin":{"minds":"dist/cli.js"},"dist":{"shasum":"20e8c930546b4cb211ae66025222982aa054917a","tarball":"https://registry.npmjs.org/@animocabrands/minds-cli/-/minds-cli-0.1.2.tgz","fileCount":4,"integrity":"sha512-thwEe+1F6zD7nwow/zOIWr0qQ2DhKFdmUxCMgme7zcKJXRvzWtgpsBCMGO7xrXbCY17FBFLy4CNsNnTC4WI/tQ==","signatures":[{"sig":"MEQCICGVVTAE7Wgy+5NYmviwKaLjcbJ3TlXlfp79X7StVz91AiASjQnr36goQQHOip1jrWvcL4uXAVbBXxySpKbpcd8aeA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":169797},"type":"module","_from":"file:animocabrands-minds-cli-0.1.2.tgz","engines":{"node":">=22"},"scripts":{"lint":"eslint src","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/156214efa6787b55b0c83821e31148a0/animocabrands-minds-cli-0.1.2.tgz","_integrity":"sha512-thwEe+1F6zD7nwow/zOIWr0qQ2DhKFdmUxCMgme7zcKJXRvzWtgpsBCMGO7xrXbCY17FBFLy4CNsNnTC4WI/tQ==","_npmVersion":"11.12.1","description":"Agent-first CLI for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","dependencies":{"commander":"^13.1.0","@animocabrands/minds-client-lib":"0.1.2"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-cli_0.1.2_1782809974517_0.9076014309858906","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@animocabrands/minds-cli","version":"0.1.3","license":"UNLICENSED","_id":"@animocabrands/minds-cli@0.1.3","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"bin":{"minds":"dist/cli.js"},"dist":{"shasum":"3d26e40f292648c37ed9b34cb1432038c4fc90cd","tarball":"https://registry.npmjs.org/@animocabrands/minds-cli/-/minds-cli-0.1.3.tgz","fileCount":4,"integrity":"sha512-Kc8cN7KJZJz9u8G7GsaXj8cek/Sy/KBGk61VcBTytzsXmQ5Xdd2/ADc+hG2oX1U2l4ZfthzDwUBHiG59SJNz5A==","signatures":[{"sig":"MEQCIEi4RozRlkzradFAzH76I0oz/Vv8l1eGO1GC4r2IhuZLAiBsS/b1L0nxAg1wZyc9W1+ivzJ2UnaD2qtNgvMTwZ18ew==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":182537},"type":"module","_from":"file:animocabrands-minds-cli-0.1.3.tgz","engines":{"node":">=22"},"scripts":{"lint":"eslint src","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/e565b9abeb793d965007782b130c28e4/animocabrands-minds-cli-0.1.3.tgz","_integrity":"sha512-Kc8cN7KJZJz9u8G7GsaXj8cek/Sy/KBGk61VcBTytzsXmQ5Xdd2/ADc+hG2oX1U2l4ZfthzDwUBHiG59SJNz5A==","_npmVersion":"11.12.1","description":"Agent-first CLI for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","dependencies":{"commander":"^13.1.0","@animocabrands/minds-client-lib":"0.1.3"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-cli_0.1.3_1784625370035_0.9034908191440609","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@animocabrands/minds-cli","version":"0.1.4","license":"UNLICENSED","_id":"@animocabrands/minds-cli@0.1.4","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"bin":{"minds":"dist/cli.js"},"dist":{"shasum":"04c7850f0636438c60bb3e76ce26b6751c5da089","tarball":"https://registry.npmjs.org/@animocabrands/minds-cli/-/minds-cli-0.1.4.tgz","fileCount":4,"integrity":"sha512-L2s16ebJSA6l74gUbrolDIqKApwFAlGJxUHUmx36OWLwob/l3h6t2hJaQunG5ANNZstvMqXC44uARj7QOfjOeQ==","signatures":[{"sig":"MEYCIQCFqo5ZGrwOQPpgqVMnxPAdPhyztbjXTGsbiKT9+5Vl3wIhAImnm7Ungt9Jh9B5hyDJ/iex57tGwizl+uSqZzmjS9IL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":199427},"type":"module","_from":"file:animocabrands-minds-cli-0.1.4.tgz","engines":{"node":">=22"},"scripts":{"lint":"eslint src","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/06129c5d119afed055bd39debed0e3ea/animocabrands-minds-cli-0.1.4.tgz","_integrity":"sha512-L2s16ebJSA6l74gUbrolDIqKApwFAlGJxUHUmx36OWLwob/l3h6t2hJaQunG5ANNZstvMqXC44uARj7QOfjOeQ==","_npmVersion":"11.12.1","description":"Agent-first CLI for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","dependencies":{"commander":"^13.1.0","@animocabrands/minds-client-lib":"0.1.4"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-cli_0.1.4_1787651045497_0.4893979292281001","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-06-09T09:48:37.806Z","modified":"2026-09-16T03:14:11.632Z","0.1.0":"2026-06-09T09:48:38.191Z","0.1.1":"2026-06-25T17:25:48.997Z","0.1.2":"2026-06-30T08:59:34.676Z","0.1.3":"2026-07-21T09:16:10.199Z","0.1.4":"2026-08-25T09:44:05.637Z"},"license":"UNLICENSED","description":"Agent-first CLI for Minds by Animoca Brands Builder API","maintainers":[{"email":"daniell@animocabrands.com","name":"daniel_animoca"},{"email":"julianat@animocabrands.com","name":"julianat"},{"email":"michaelg@animocabrands.com","name":"michaelg92"},{"email":"npmjs@animocabrands.com","name":"ab1-npmjs"},{"email":"jackyy@animocabrands.com","name":"jackyyab1"},{"email":"andys@animocabrands.com","name":"andysob"}],"readme":"# @animocabrands/minds-cli\n\nAgent-first CLI for the **Hello Minds Builder API** ([api.build](https://api.build.hellominds.ai)) — JSON stdout, predictable exit codes, and copy-pasteable `--help` examples for automation.\n\n**Get started:** [Minds CLI guide](https://build.hellominds.ai/docs/get-started/cli) on build.hellominds.ai\n\n**Requirements:** Node.js ≥ 22.\n\n## Install\n\n```bash\n# Global (human PATH)\nnpm install -g @animocabrands/minds-cli\n\n# No global install (agents, CI, sandboxes)\nnpx @animocabrands/minds-cli@latest <command>\n```\n\n## Authentication\n\nNo `minds login`. Create a **Builder API key** at [build.hellominds.ai/console](https://build.hellominds.ai/console), then set:\n\n```bash\nexport MINDS_BUILDER_API_KEY=your_key_here\n```\n\nOr pass `--builder-api-key <key>` (legacy alias: `--access-key`). The CLI also loads `.env` from the current working directory.\n\n**Bazaar commands** (`minds bazaar …`) are public catalog routes — no API key required.\n\n## Output\n\nDefault stdout is **one JSON object** per command:\n\n| Outcome           | Shape                                                               |\n| ----------------- | ------------------------------------------------------------------- |\n| List success      | `{ \"ok\": true, \"items\": [...] }`                                    |\n| Singleton success | `{ \"ok\": true, \"<resource>\": T }`                                   |\n| Failure           | `{ \"ok\": false, \"error\": \"...\", \"message\": \"...\", \"hint?\": \"...\" }` |\n\nUse `--pretty` for indented JSON. `minds events` prints **NDJSON** (one SSE object per line, no wrapper). Diagnostics go to stderr (`info:`, `warn:`, `error:`).\n\n## Exit codes\n\n| Code | Meaning                                   |\n| ---- | ----------------------------------------- |\n| 0    | success                                   |\n| 2    | user error (bad args, invalid flags, 4xx) |\n| 3    | server / timeout / network                |\n| 4    | auth (missing key)                        |\n| 5    | rate limit (429)                          |\n\n## Quick start\n\n```bash\nminds doctor\nminds list\nMIND_ID=$(minds list | jq -r '.items[0].mindId')\nminds chat create --mind \"$MIND_ID\" --alias main\nminds send main \"Hello\" --wait --timeout 120000\n```\n\nResolve Mind UUIDs with `minds list | jq` — `--mind` flags accept **UUID only**.\n\n## Commands\n\n### Doctor & account\n\n| Command        | Auth     | Description                                             |\n| -------------- | -------- | ------------------------------------------------------- |\n| `minds doctor` | optional | api.build ping, key check, messaging probe, CLI version |\n| `minds list`   | yes      | List Minds (`mindId`, `name`)                           |\n\n### Messaging\n\n| Command                                           | Description                                                       |\n| ------------------------------------------------- | ----------------------------------------------------------------- |\n| `minds chat list`                                 | List conversations                                                |\n| `minds chat show <alias>`                         | Conversation detail (`--history-limit N`)                         |\n| `minds chat create --mind <uuid> --alias <alias>` | Create or ensure conversation                                     |\n| `minds send <alias> [text]`                       | Send message (`--wait`, `--timeout <ms>`, `--attachments <file>`) |\n| `minds history <alias>`                           | Newest-first history (`--limit`, `--cursor` for the next older page) |\n| `minds events [alias]`                            | SSE stream as NDJSON                                              |\n\nMind replies are often slow — use `--timeout 180000` or `minds history <alias>` after a timeout.\n\n### Cognition balance\n\n| Command                                              | Description                |\n| ---------------------------------------------------- | -------------------------- |\n| `minds usage show --mind <uuid> [--interval 1d]`     | Cognition spend over time  |\n| `minds usage by-tool --mind <uuid> [--interval day]` | Spend breakdown by tool    |\n| `minds cognition balance --mind <uuid>`              | Per-Mind cognition balance |\n\nInterval enums differ per subcommand — invalid values exit **2** with a hint before any HTTP call.\n\n### Mind status\n\n| Command                            | Description                                     |\n| ---------------------------------- | ----------------------------------------------- |\n| `minds mind show --mind <uuid>`    | Full Mind details (`walletAddress`, `chain`, …) |\n| `minds mind check-name --name <n>` | Public name availability (`{ ok, check }`)      |\n| `minds mind awaken --name --id`    | Create a Mind (`POST /v1/minds/awaken`)         |\n| `minds mind disable --mind <uuid>` | Disable a Mind (`isEnabled: false`)             |\n| `minds mind enable --mind <uuid>`  | Enable a Mind (`isEnabled: true`)               |\n\nIdempotent status toggles — safe to retry. `awaken` requires `--name` and `--id`. `--help` prints a **CLI-local** id snapshot; check [the API reference](https://build.hellominds.ai/docs/api) for the latest slugs. Unknown `--id` is forwarded (the API 400s if it is invalid).\n\n### Equipped skills & apps\n\nBazaar discovers IDs; these commands manage what is equipped on a Mind.\n\n| Command                                                         | Description                          |\n| --------------------------------------------------------------- | ------------------------------------ |\n| `minds mind skills list --mind <uuid>`                          | List equipped skills                 |\n| `minds mind skills equip --mind <uuid> --id <skillId> […]`     | Equip skills                         |\n| `minds mind skills unequip --mind <uuid> --id <skillId> […]`   | Unequip skills                       |\n| `minds mind apps list --mind <uuid>`                            | List equipped apps                   |\n| `minds mind apps equip --mind <uuid> --id <appId> […]`         | Equip apps                           |\n| `minds mind apps unequip --mind <uuid> --id <appId> […]`       | Unequip apps                         |\n\n### Bazaar (public catalog)\n\n| Command                              | Description                     |\n| ------------------------------------ | ------------------------------- |\n| `minds bazaar search <query>`        | Merged skills + apps search     |\n| `minds bazaar skills list`           | List or search skills           |\n| `minds bazaar skills show <skillId>` | Skill detail                    |\n| `minds bazaar apps list`             | List or search apps             |\n| `minds bazaar apps show <appId>`     | App detail (includes `tools[]`) |\n\nSearch flags: `--max` (1–200), `--sort equipped|name|newest`, `--tier wild|verified` (apps), `--provider <slug>` (client-side on apps). Search auto-fetches up to 200 rows internally. Browse without `--search` returns the first catalog slice with `truncated: true` when more rows exist.\n\n### Circles\n\n| Command                                                     | Description                                                |\n| ----------------------------------------------------------- | ---------------------------------------------------------- |\n| `minds circle show --mind <uuid>`                           | Members for one Mind (steward, humans, and other Minds)    |\n| `minds circle list`                                         | All circles (N+1: one GET per Mind)                        |\n| `minds circle add --mind <uuid> --email <e> [--email …]`    | Add collaborators (human or Mind emails)           |\n| `minds circle remove --mind <uuid> --email <e> [--dry-run]` | Remove collaborators                                       |\n\nHuman emails can be any address. Mind emails end in `@hellominds.ai`.\nThe steward is already in the circle. Confirm with `minds circle show`.\n\n## jq recipes\n\n```bash\nminds history main --limit 50 | jq '.items[-1].fingerprint'\nminds mind check-name --name J-Belfort | jq '.check.isAvailable'\nminds mind awaken --name J-Belfort --id sales | jq '.mind.mindId'\nminds send main \"hi\" --wait | jq '.reply.messageText'\nminds cognition balance --mind \"$MIND_ID\" | jq '.balance.cognition'\nminds bazaar search \"workflow\" --max 10 | jq '.skills.items[].name'\nminds circle list | jq '.items[] | {mindId, memberCount: (.members | length)}'\n```\n\n## Global flags\n\n| Flag                      | Description                         |\n| ------------------------- | ----------------------------------- |\n| `--pretty`                | Pretty-print JSON stdout            |\n| `--builder-api-key <key>` | Override `MINDS_BUILDER_API_KEY`    |\n| `--quiet`                 | Suppress info diagnostics on stderr |\n| `--no-color`              | Disable ANSI colors on stderr       |\n| `-V, --version`           | CLI version                         |\n\nEvery subcommand has `minds <group> <subcmd> --help` with **Examples:** — e.g.\n`minds usage by-tool --help`. Multi-segment help also works: `minds help usage by-tool`.\n\n## Library\n\nProgrammatic use? See [@animocabrands/minds-client-lib](https://www.npmjs.com/package/@animocabrands/minds-client-lib) — same api.build routes without the JSON envelope.\n\n## License\n\nUNLICENSED — private alpha tooling.\n","readmeFilename":"README.md"}