{"_id":"@ada-diamonds/cli","_rev":"3-addb89d802b5c7e409495855596cceef","name":"@ada-diamonds/cli","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@ada-diamonds/cli","version":"1.0.0","keywords":["ada-diamonds","lab-grown-diamonds","diamonds","engagement-rings","jewelry","cli","api"],"license":"MIT","_id":"@ada-diamonds/cli@1.0.0","maintainers":[{"name":"cesar777","email":"cesarbenavides@icloud.com"}],"homepage":"https://www.adadiamonds.com/developers","bugs":{"url":"mailto:developers@adadiamonds.com"},"bin":{"ada":"bin/ada.js"},"dist":{"shasum":"22d17097832b194a31d6bd2b6cf1f15c4b0b2a89","tarball":"https://registry.npmjs.org/@ada-diamonds/cli/-/cli-1.0.0.tgz","fileCount":3,"integrity":"sha512-sSTP7mwaAZzwtw7N6oSBgfhnI3scza0iiRNCcA4/VEfYVUedcLfR9a2MshAt/YN1iL+nMta0DE3fn3YKEan3Ig==","signatures":[{"sig":"MEUCIDbZH32Vo6fxjJFIeI2b+AbS5nH2O1+g5iRdexOnQMmDAiEA3b1RSEmWFLiXVTsQmJa209NN1JFvHY60wF9LqTuzFUk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12245},"type":"module","engines":{"node":">=18"},"gitHead":"0b5c8995796481b8f7f5f68f19eab0b5bbe021db","_npmUser":{"name":"cesar777","email":"cesarbenavides@icloud.com"},"repository":{"url":"git+https://github.com/adadiamonds/ada-diamonds-nextjs.git","type":"git","directory":"packages/ada-cli"},"_npmVersion":"11.12.1","description":"Official Ada Diamonds CLI — search lab grown diamonds, engagement ring settings, and fine jewelry from the terminal.","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_1.0.0_1787418242356_0.27399232957393527","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ada-diamonds/cli","version":"1.0.1","keywords":["ada-diamonds","lab-grown-diamonds","diamonds","engagement-rings","jewelry","cli","api","adadiamonds","mcp","ai-agent","lab-diamonds","openapi"],"license":"MIT","_id":"@ada-diamonds/cli@1.0.1","maintainers":[{"name":"cesar777","email":"cesarbenavides@icloud.com"}],"homepage":"https://www.adadiamonds.com/developers","bugs":{"url":"mailto:it@adadiamonds.com"},"bin":{"ada":"bin/ada.js"},"dist":{"shasum":"aa0205204864f2a53a069865195d16fdb8a203d8","tarball":"https://registry.npmjs.org/@ada-diamonds/cli/-/cli-1.0.1.tgz","fileCount":3,"integrity":"sha512-/TYlvbUG91ylxn5kYODHTwGTlZHpBSYO2+lIHOq74egSsmj2Nwnwrobysx02js99gebdfdnajcRZ/QivC6OzIw==","signatures":[{"sig":"MEUCIQDqUr9301aG0wuLpqcNkWAy5TAf6IvNnWTba48JJWs+1gIgVd8RUvsRiaxkya56/L42xlL4Vde/lBqN2geluXicchw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12343},"type":"module","engines":{"node":">=18"},"gitHead":"8c73e6e338ef3a88586f3d47a635b84751cdee1b","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f8c3c0cb-d1c8-4556-be02-df9b2ad9791a"}},"repository":{"url":"git+https://github.com/adadiamonds/ada-diamonds-nextjs.git","type":"git","directory":"packages/ada-cli"},"_npmVersion":"12.0.2","description":"Official Ada Diamonds CLI — search lab grown diamonds, engagement ring settings, and fine jewelry from the terminal.","directories":{},"_nodeVersion":"22.23.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_1.0.1_1787422853337_0.61416873762553","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@ada-diamonds/cli","version":"1.0.2","description":"Official Ada Diamonds CLI — search lab grown diamonds, engagement ring settings, and fine jewelry from the terminal.","keywords":["ada-diamonds","lab-grown-diamonds","diamonds","engagement-rings","jewelry","cli","api","adadiamonds","mcp","ai-agent","lab-diamonds","openapi"],"homepage":"https://www.adadiamonds.com/developers","bugs":{"url":"https://github.com/adadiamonds/agent-tools/issues"},"license":"MIT","type":"module","bin":{"ada":"bin/ada.js"},"engines":{"node":">=18"},"repository":{"type":"git","url":"git+https://github.com/adadiamonds/agent-tools.git","directory":"cli"},"gitHead":"08bd588bc83588d29cb1f8df115e5accb52250ba","_id":"@ada-diamonds/cli@1.0.2","_nodeVersion":"22.23.2","_npmVersion":"12.0.2","dist":{"integrity":"sha512-XVmUWVF05x8Ev6jJLn6ST8xCoTp+Rq3sEgDegZGoGyxHfV2LjNkqwVGyepTDTK2wz0ty939rlW2KZI9c/yrBPg==","shasum":"92bd5d5be6a174c92ef92f7f17b69d660871966e","tarball":"https://registry.npmjs.org/@ada-diamonds/cli/-/cli-1.0.2.tgz","fileCount":3,"unpackedSize":12346,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEyp/DiMCfSQOlEZZuS5jQcJICJJpBy4qmpU26SPg6WkAiBfOP074RnaEG5sDbyN7psg+u9AhG0p14OFpvGp3LKu3w=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f8c3c0cb-d1c8-4556-be02-df9b2ad9791a"}},"directories":{},"maintainers":[{"name":"cesar777","email":"cesarbenavides@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_1.0.2_1787844860272_0.6494991849390945"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-22T17:04:02.212Z","modified":"2026-08-27T15:34:20.646Z","1.0.0":"2026-08-22T17:04:02.505Z","1.0.1":"2026-08-22T18:20:53.475Z","1.0.2":"2026-08-27T15:34:20.399Z"},"bugs":{"url":"https://github.com/adadiamonds/agent-tools/issues"},"license":"MIT","homepage":"https://www.adadiamonds.com/developers","keywords":["ada-diamonds","lab-grown-diamonds","diamonds","engagement-rings","jewelry","cli","api","adadiamonds","mcp","ai-agent","lab-diamonds","openapi"],"repository":{"type":"git","url":"git+https://github.com/adadiamonds/agent-tools.git","directory":"cli"},"description":"Official Ada Diamonds CLI — search lab grown diamonds, engagement ring settings, and fine jewelry from the terminal.","maintainers":[{"name":"cesar777","email":"cesarbenavides@icloud.com"}],"readme":"# @ada-diamonds/cli\n\nOfficial command-line client for the [Ada Diamonds](https://www.adadiamonds.com) agent API — search live lab grown diamond inventory, engagement ring settings, and fine jewelry from the terminal.\n\n```bash\nnpx @ada-diamonds/cli diamonds --shape Oval --min-carat 1 --max-price 4000\n```\n\n```\nCARAT  SHAPE  COLOR  CLARITY  PRICE   REPORT\n-----  -----  -----  -------  ------  ---------------\n1.02   Oval   E      VS1      $1,200  IGI LG538299162\n1.20   Oval   F      VS2      $1,150  IGI LG530297354\n```\n\nNo account, no API key, no signup — the catalog is readable anonymously.\n\n## Install\n\n```bash\nnpm install -g @ada-diamonds/cli    # then: ada diamonds --help\nnpx @ada-diamonds/cli --help        # or run it without installing\n```\n\nRequires Node 18+ (uses the built-in `fetch`). No dependencies.\n\n## Commands\n\n| Command | Does |\n| --- | --- |\n| `ada diamonds` | Search available loose lab grown diamonds |\n| `ada rings` | Search engagement ring settings |\n| `ada jewelry` | Search wedding bands, earrings, necklaces, bracelets |\n| `ada guides` | List knowledge base articles |\n| `ada read <slug>` | Print one article as markdown |\n| `ada showrooms` | Showroom locations and remote consultation options |\n| `ada open` | Print this deployment's API, MCP, and docs URLs |\n\nAdd `--json` to any command for the raw API response:\n\n```bash\nada guides --json | jq -r '.data[].slug'\nada diamonds --shape Emerald --json | jq '.pagination.total'\n```\n\n## How Ada prices a ring\n\nAn engagement ring is a **setting** plus a **loose diamond**, priced separately. `ada rings` shows setting prices, which exclude the center stone. To quote a complete ring, add a setting and a diamond:\n\n```bash\nada rings --shape Oval --type Solitaire --limit 1\nada diamonds --shape Oval --min-carat 1.5 --sort price_asc --limit 1\n```\n\nAll prices are US dollars.\n\n## Environment\n\n| Variable | Purpose |\n| --- | --- |\n| `ADA_API_KEY` | Optional credential; raises the rate limit from 120 to 600 requests/minute |\n| `ADA_API_BASE` | Override the host (defaults to `https://www.adadiamonds.com`) |\n\nGet a key instantly, no account required:\n\n```bash\ncurl -X POST https://www.adadiamonds.com/api/v1/keys \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\":\"my-cli\",\"env\":\"sandbox\"}'\n```\n\n## Also available\n\n- **REST API** — <https://www.adadiamonds.com/api/v1>\n- **OpenAPI 3.1** — <https://www.adadiamonds.com/openapi.json>\n- **MCP server** (Streamable HTTP) — `https://www.adadiamonds.com/mcp`\n- **Docs** — <https://www.adadiamonds.com/developers>\n\n## Support\n\n<it@adadiamonds.com> · [Terms](https://www.adadiamonds.com/terms) · [Privacy](https://www.adadiamonds.com/privacy)\n","readmeFilename":"README.md"}