{"_id":"@aisystemresources/whatelz","name":"@aisystemresources/whatelz","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@aisystemresources/whatelz","version":"0.2.0","description":"CLI for whatelz.ai — token-efficient companion to the HTTP MCP with stdio MCP server support","type":"module","bin":{"whatelz":"dist/index.js"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/AISystemResources/whatelzai.git","directory":"cli"},"homepage":"https://whatelz.ai","license":"UNLICENSED","engines":{"node":">=20"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","prepublishOnly":"npm run build"},"dependencies":{"commander":"^12.1.0","open":"^10.1.0"},"devDependencies":{"@types/node":"^22.7.4","tsx":"^4.19.1","typescript":"^5.6.3"},"gitHead":"66c3609d6f24b2ddcb82a382e7ce9df8372e84f4","_id":"@aisystemresources/whatelz@0.2.0","bugs":{"url":"https://github.com/AISystemResources/whatelzai/issues"},"_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-qrONDrUCkPB5ArcR2Va9EmfuGyuSkVIgJXe5hyIl5lmwt0Nyr9dLJGSZNUyxrH/oDKtLbH5t/OQ1as1TThGBxw==","shasum":"af8d18c085a1cad1f4f283b9e149a7bf090ff228","tarball":"https://registry.npmjs.org/@aisystemresources/whatelz/-/whatelz-0.2.0.tgz","fileCount":6,"unpackedSize":18420,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCs5tfX6Ot9xU1h/R1T+WWhkjlMjtkvQH8Qwwf+DHC/KgIgIJ0J6Y6RlRmrDWhnL6A1+TNZYPIUjA2W3t+XZZQrNGw="}]},"_npmUser":{"name":"whatelzai","email":"elz.work22@gmail.com"},"directories":{},"maintainers":[{"name":"whatelzai","email":"elz.work22@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/whatelz_0.2.0_1785568009797_0.9298264090459425"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-01T07:06:49.580Z","0.2.0":"2026-08-01T07:06:49.958Z","modified":"2026-08-01T07:06:50.232Z"},"maintainers":[{"name":"whatelzai","email":"elz.work22@gmail.com"}],"description":"CLI for whatelz.ai — token-efficient companion to the HTTP MCP with stdio MCP server support","homepage":"https://whatelz.ai","repository":{"type":"git","url":"git+https://github.com/AISystemResources/whatelzai.git","directory":"cli"},"bugs":{"url":"https://github.com/AISystemResources/whatelzai/issues"},"license":"UNLICENSED","readme":"# whatelz CLI\n\nToken-efficient companion to the whatelz.ai HTTP MCP. Use it in **Claude Code** sessions to keep large read responses out of Claude's context (pipe to `jq`/`grep`). Claude.ai / Claude Desktop keep using the HTTP MCP directly.\n\nSame backend, same verbs — the CLI is a thin wrapper that authenticates via the same Clerk-gated OAuth authorize page.\n\n## Install\n\n```bash\nnpm install -g @aisystemresources/whatelz\n```\n\nOr from this repo during dev:\n\n```bash\ncd cli && npm install && npm run build && npm link\n```\n\n## Login\n\n```bash\nwhatelz login\n```\n\nOpens a browser to whatelz.ai, you click **Authorize**, an owner-scoped `auth_token` is issued and stashed at `~/.config/whatelz/credentials/default.json` (chmod 600). Tokens do not hard-expire — revoke manually via [/admin/tokens](https://whatelz.ai/admin/tokens) if compromised.\n\n## Profiles\n\nEvery credential lives under a named profile. `default` is used unless you specify otherwise. Future service accounts (CMO/COO/CPO/CEO agents) get their own profile.\n\n```bash\nwhatelz login --profile cmo             # log in as a separate profile\nwhatelz --profile cmo whoami            # use the cmo profile for one call\nWHATELZ_PROFILE=cmo whatelz whoami      # or set for the session\nwhatelz profiles                        # list all local profiles\n```\n\n## Usage\n\n```bash\nwhatelz verbs                                # list every MCP verb + description\nwhatelz whoami                               # confirm auth + ping the MCP\nwhatelz call testimonials.list_public        # call a verb, args default to {}\nwhatelz call dashboard.upsert_card --args '{\"key\":\"foo\",\"title\":\"Foo\",\"body_markdown\":\"...\"}'\nwhatelz logout                               # remove local token\n```\n\nPipe to `jq` for token conservation:\n\n```bash\nwhatelz call testimonials.list_public | jq '.[] | { id, headline, author_name }'\nwhatelz call dashboard.list_cards | jq '.[] | { key, updated_at }'\n```\n\n## Claude Code MCP registration\n\nRegister `whatelz` as a native MCP server in Claude Code by adding to your `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"whatelz\": {\n      \"command\": \"whatelz\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\nFor a scoped agent profile:\n\n```json\n{\n  \"mcpServers\": {\n    \"whatelz-cmo\": {\n      \"command\": \"whatelz\",\n      \"args\": [\"--profile\", \"cmo\", \"mcp\"]\n    }\n  }\n}\n```\n\nEvery whatelz verb then shows up in Claude Code's tool list. The stdio subcommand is a thin JSON-RPC proxy to the HTTP MCP — no protocol reimplementation, no drift.\n\n## Env\n\n- `WHATELZ_ORIGIN` — override the target host (default `https://whatelz.ai`). Set to `http://localhost:3100` for local dev.\n- `WHATELZ_PROFILE` — override the active credential profile (default `default`).\n\n## Why this exists\n\nPer the [MCP Verb and Auth Contract](https://emdee.tech/edmund/projects/MCP-VERB-AND-AUTH-CONTRACT) in EMDEE, each product targets dual-channel access:\n\n- **CLI** for Claude Code (subprocess, pipes, token-efficient, stdio MCP server)\n- **HTTP MCP** for Claude.ai / Desktop / mobile (only channel available)\n\nZero verb divergence: the CLI does not add commands the MCP lacks, and vice versa.\n","readmeFilename":"README.md","_rev":"1-b23ac392d84379f115f153176496da23"}