{"_id":"@artos-commerce/ucp-cli","_rev":"8-8fd3dd57a395115e4b196b17a5ebfa18","name":"@artos-commerce/ucp-cli","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.0":{"name":"@artos-commerce/ucp-cli","version":"0.1.0","keywords":["artos","ucp","agent-commerce","cli","mcp","ap2"],"license":"MIT","_id":"@artos-commerce/ucp-cli@0.1.0","maintainers":[{"name":"mkitsos","email":"mkitsos@gmail.com"}],"homepage":"https://docs.artos.sh/agents","bugs":{"url":"https://github.com/artos-commerce/artos-ucp-cli/issues"},"bin":{"artos":"dist/index.js"},"dist":{"shasum":"a2ca222eaf25e00a622edbc690567f6c897ae2a3","tarball":"https://registry.npmjs.org/@artos-commerce/ucp-cli/-/ucp-cli-0.1.0.tgz","fileCount":56,"integrity":"sha512-4gchfEB2jcGtiUkNRW8AofxV0qlYc6o1En89a3OtFKEyugYAdnXYHcWrurd1coVObCss2Z20VPo8+ahN4DKjFQ==","signatures":[{"sig":"MEUCIF3Lf2T9kXnxmwfHErFz/VJp/npVwyBoIOCoLqa4/gvUAiEAgjsDaX+XM5lEVZagmC9YAdChBWxPN6OkL+luvZFyESI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":122043},"type":"module","engines":{"node":">=20"},"gitHead":"01cfab173c13436fca7d331a4fd2d5d8a6ed4e4f","scripts":{"lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","check":"npm run lint && npm run typecheck && npm run test:coverage && npm run build","lint:fix":"eslint . --fix","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"npm run check"},"_npmUser":{"name":"mkitsos","email":"mkitsos@gmail.com"},"repository":{"url":"git+https://github.com/artos-commerce/artos-ucp-cli.git","type":"git"},"_npmVersion":"11.13.0","description":"Command-line tools for building agents on Artos: scaffold an agent UCP profile, run connectivity diagnostics, inspect a store's UCP profile, and search the cross-store catalog.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"@artos-commerce/ucp-client":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.39.4","vitest":"^2.1.0","globals":"^17.7.0","prettier":"^3.8.3","@eslint/js":"^9.39.4","typescript":"^5.6.0","@types/node":"^20.19.42","typescript-eslint":"^8.62.0","@vitest/coverage-v8":"^2.1.9","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.6"},"_npmOperationalInternal":{"tmp":"tmp/ucp-cli_0.1.0_1782640653617_0.17683750104534868","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@artos-commerce/ucp-cli","version":"0.1.1","keywords":["artos","ucp","agent-commerce","cli","mcp","ap2"],"license":"MIT","_id":"@artos-commerce/ucp-cli@0.1.1","maintainers":[{"name":"mkitsos","email":"mkitsos@gmail.com"}],"homepage":"https://docs.artos.sh/agents","bin":{"artos":"dist/index.js"},"dist":{"shasum":"f96de65af5b6c4fe9ec2a76f85f9d7faa4a575a0","tarball":"https://registry.npmjs.org/@artos-commerce/ucp-cli/-/ucp-cli-0.1.1.tgz","fileCount":56,"integrity":"sha512-gGyYNlKuIYkV/hyVuELtXrmjuJkCiRwu3pCenbW3fi2mCpzAPuVWhnLPbl6BumD1BZpmULEa3kf09TYMQHHPlw==","signatures":[{"sig":"MEUCIQCH7RtT7LZBKY5yo5xVHjTNkWkqL3AHpMjflnSj6jp7TwIgG7bDVytgRvNnAa4w7gKOmYq/zcuz6r0GcvrRWd7fqPY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":122358},"type":"module","engines":{"node":">=20"},"gitHead":"02c40c928600eb0c683490104487d990790c1936","scripts":{"lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","check":"npm run lint && npm run typecheck && npm run test:coverage && npm run build","lint:fix":"eslint . --fix","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"npm run check"},"_npmUser":{"name":"mkitsos","email":"mkitsos@gmail.com"},"_npmVersion":"11.13.0","description":"Command-line tools for building agents on Artos: scaffold an agent UCP profile, run connectivity diagnostics, inspect a store's UCP profile, and search the cross-store catalog.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"@artos-commerce/ucp-client":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.39.4","vitest":"^4.1.9","globals":"^17.7.0","prettier":"^3.8.3","@eslint/js":"^9.39.4","typescript":"^5.6.0","@types/node":"^20.19.42","typescript-eslint":"^8.62.0","@vitest/coverage-v8":"^4.1.9","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.6"},"_npmOperationalInternal":{"tmp":"tmp/ucp-cli_0.1.1_1782653487763_0.6866220625096229","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@artos-commerce/ucp-cli","version":"0.1.2","keywords":["artos","ucp","agent-commerce","cli","mcp","ap2"],"license":"MIT","_id":"@artos-commerce/ucp-cli@0.1.2","maintainers":[{"name":"mkitsos","email":"mkitsos@gmail.com"}],"homepage":"https://docs.artos.sh/agents","bin":{"artos":"dist/index.js"},"dist":{"shasum":"e9220c774c62a571144a06c7ea388db2c00ea8d5","tarball":"https://registry.npmjs.org/@artos-commerce/ucp-cli/-/ucp-cli-0.1.2.tgz","fileCount":56,"integrity":"sha512-NS4LJmMtEgUjjW/iXmGfGVB2KHA8WIxau3gFIUMZ/atNl5dKfeHv7qXL9IYZHGUGCgm6Fk9KISe2tzrQw26aXw==","signatures":[{"sig":"MEUCIQC8KPKZWFA5t74V+rxyB7/EEBfFxyWJvARCiNodb8lkcwIgeqZrE6AENtwP0ygy6gPFfSwKgG2ab01IQHB/49YPiJ0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":124878},"type":"module","engines":{"node":">=20"},"gitHead":"ab256289a5357908b126a268a60e0efc8eb5f094","scripts":{"lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","check":"npm run lint && npm run typecheck && npm run test:coverage && npm run build","lint:fix":"eslint . --fix","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"npm run check"},"_npmUser":{"name":"mkitsos","email":"mkitsos@gmail.com"},"_npmVersion":"11.13.0","description":"Command-line tools for building agents on Artos: scaffold an agent UCP profile, run connectivity diagnostics, inspect a store's UCP profile, and search the cross-store catalog.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"@artos-commerce/ucp-client":"^0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.39.4","vitest":"^4.1.9","globals":"^17.7.0","prettier":"^3.8.3","@eslint/js":"^9.39.4","typescript":"^5.6.0","@types/node":"^20.19.42","typescript-eslint":"^8.62.0","@vitest/coverage-v8":"^4.1.9","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.6"},"_npmOperationalInternal":{"tmp":"tmp/ucp-cli_0.1.2_1782653870798_0.3704433998655521","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@artos-commerce/ucp-cli","version":"0.1.3","keywords":["artos","ucp","agent-commerce","cli","mcp","ap2"],"license":"MIT","_id":"@artos-commerce/ucp-cli@0.1.3","maintainers":[{"name":"mkitsos","email":"mkitsos@gmail.com"}],"homepage":"https://docs.artos.sh/agents","bin":{"artos":"dist/index.js"},"dist":{"shasum":"319fa3ef8e60f07045b51a20a0c0801bbfca70f4","tarball":"https://registry.npmjs.org/@artos-commerce/ucp-cli/-/ucp-cli-0.1.3.tgz","fileCount":56,"integrity":"sha512-fKmrwrnr4fcxAQ7y3ej4GgiE2TE2ffbb5DIFqNBLQCWh8kcJb800358zTrJCN0yWT241KT7+wtRlci38+U5T2w==","signatures":[{"sig":"MEUCIQCizYcB21YZm8zvbj39IyXvx55i0bO/zxpYGCDAUbXHUQIgOkQKgwQbHrhpCrJltAV8m+A+wkDy70VO+csl69cXiZA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":124878},"type":"module","engines":{"node":">=20"},"gitHead":"2d89efb02c14b16dc3645d502f972410a76e9a47","scripts":{"lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","check":"npm run lint && npm run typecheck && npm run test:coverage && npm run build","lint:fix":"eslint . --fix","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"npm run check"},"_npmUser":{"name":"mkitsos","email":"mkitsos@gmail.com"},"_npmVersion":"11.13.0","description":"Command-line tools for building agents on Artos: scaffold an agent UCP profile, run connectivity diagnostics, inspect a store's UCP profile, and search the cross-store catalog.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"@artos-commerce/ucp-client":"^0.2.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.39.4","vitest":"^4.1.9","globals":"^17.7.0","prettier":"^3.8.3","@eslint/js":"^9.39.4","typescript":"^5.6.0","@types/node":"^20.19.42","typescript-eslint":"^8.62.0","@vitest/coverage-v8":"^4.1.9","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.6"},"_npmOperationalInternal":{"tmp":"tmp/ucp-cli_0.1.3_1782654347977_0.5843399202023614","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@artos-commerce/ucp-cli","version":"0.2.0","keywords":["artos","ucp","agent-commerce","cli","mcp","ap2"],"license":"MIT","_id":"@artos-commerce/ucp-cli@0.2.0","maintainers":[{"name":"mkitsos","email":"mkitsos@gmail.com"}],"homepage":"https://docs.artos.sh/agents","bin":{"artos":"dist/index.js"},"dist":{"shasum":"9459534a5d39930b5cab44ca759347b69711256e","tarball":"https://registry.npmjs.org/@artos-commerce/ucp-cli/-/ucp-cli-0.2.0.tgz","fileCount":62,"integrity":"sha512-3WMepV4GRL2UvxmOtT0uO55hWrCLiBzi0wxN390yIxvblj1D0lR1cJYCeRH00XDp1Z1j2alT70eSRR0+a0VsYw==","signatures":[{"sig":"MEUCIE0vyy/Brng2st9/8SyCUvP/b3u7q36ZRvGCwQpaeXNAAiEA6aYGDojETsJHN1nl2OTAzdzWZH2K3VyKQ5p2y4u0lTs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":140082},"type":"module","engines":{"node":">=20"},"gitHead":"f6e62a8a78ca816f30efad2d02acc3e68b6fca10","scripts":{"lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","check":"npm run lint && npm run typecheck && npm run test:coverage && npm run build","lint:fix":"eslint . --fix","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"npm run check"},"_npmUser":{"name":"mkitsos","email":"mkitsos@gmail.com"},"_npmVersion":"11.13.0","description":"Command-line tools for building agents on Artos: scaffold an agent UCP profile, run connectivity diagnostics, inspect a store's UCP profile, and search the cross-store catalog.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"@artos-commerce/ucp-client":"^0.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.39.4","vitest":"^4.1.9","globals":"^17.7.0","prettier":"^3.8.3","@eslint/js":"^9.39.4","typescript":"^5.6.0","@types/node":"^20.19.42","typescript-eslint":"^8.62.0","@vitest/coverage-v8":"^4.1.9","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.6"},"_npmOperationalInternal":{"tmp":"tmp/ucp-cli_0.2.0_1782672674273_0.16664531931560167","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@artos-commerce/ucp-cli","version":"0.2.1","keywords":["artos","ucp","agent-commerce","cli","mcp","ap2"],"license":"MIT","_id":"@artos-commerce/ucp-cli@0.2.1","maintainers":[{"name":"mkitsos","email":"mkitsos@gmail.com"}],"homepage":"https://docs.artos.sh/agents","bin":{"artos":"dist/index.js"},"dist":{"shasum":"8dcb75524b545702adeec050ae940b62c2a98060","tarball":"https://registry.npmjs.org/@artos-commerce/ucp-cli/-/ucp-cli-0.2.1.tgz","fileCount":62,"integrity":"sha512-HgMbsHfgRXEMMuyFhf6SiigYtt5zPBKRy1DexHaaQ/QIQ/oe2hp0J4p2EK08bWQT7N2QMlI3pRlx33wpFiTGNw==","signatures":[{"sig":"MEYCIQCAgY1gaDlMbjg5hNvGwuR07WiCgpbkDaZ4FAYFKgqKEgIhALYD4hTMC5B3MAidtWYetUwadyKmFwdGRnidPIBgJBBq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":139952},"type":"module","engines":{"node":">=20"},"gitHead":"cc866dd5472084b74097a3d46cc44aeb75920f55","scripts":{"lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","check":"npm run lint && npm run typecheck && npm run test:coverage && npm run build","lint:fix":"eslint . --fix","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"npm run check"},"_npmUser":{"name":"mkitsos","email":"mkitsos@gmail.com"},"_npmVersion":"11.13.0","description":"Command-line tools for building agents on Artos: scaffold an agent UCP profile, run connectivity diagnostics, inspect a store's UCP profile, and search the cross-store catalog.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"@artos-commerce/ucp-client":"^0.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.39.4","vitest":"^4.1.9","globals":"^17.7.0","prettier":"^3.8.3","@eslint/js":"^9.39.4","typescript":"^5.6.0","@types/node":"^20.19.42","typescript-eslint":"^8.62.0","@vitest/coverage-v8":"^4.1.9","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.6"},"_npmOperationalInternal":{"tmp":"tmp/ucp-cli_0.2.1_1782673298786_0.123459021070768","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@artos-commerce/ucp-cli","version":"0.3.0","keywords":["artos","ucp","agent-commerce","cli","mcp","ap2"],"license":"MIT","_id":"@artos-commerce/ucp-cli@0.3.0","maintainers":[{"name":"mkitsos","email":"mkitsos@gmail.com"}],"homepage":"https://docs.artos.sh/agents","bin":{"artos":"dist/index.js"},"dist":{"shasum":"78844f0477ade006dceef9716f54824952540421","tarball":"https://registry.npmjs.org/@artos-commerce/ucp-cli/-/ucp-cli-0.3.0.tgz","fileCount":62,"integrity":"sha512-6rxGf/1TtoqYaEShvFVn9L+0U2HLweJHhymSTOUw70NauwRlseEp5k/dXUBjT3+wnO5hFn6JgyKEUnMMYEjiDg==","signatures":[{"sig":"MEUCIQDmyj+u6iAHQdZ9rzC0zvdPgOFYlXom+izYQqJy6Q2RtQIgCRHguw60q7ykWJa5lEojwmn1vJf8oy5sTX/+GILAvhg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":139951},"type":"module","engines":{"node":">=22"},"gitHead":"34d228ca6c04a852d81ca6d18c584aff6ff61ce5","scripts":{"lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","check":"npm run lint && npm run typecheck && npm run test:coverage && npm run build","lint:fix":"eslint . --fix","typecheck":"tsc -p tsconfig.json --noEmit","test:watch":"vitest","test:coverage":"vitest run --coverage","prepublishOnly":"npm run check"},"_npmUser":{"name":"mkitsos","email":"mkitsos@gmail.com"},"_npmVersion":"11.13.0","description":"Command-line tools for building agents on Artos: scaffold an agent UCP profile, run connectivity diagnostics, inspect a store's UCP profile, and search the cross-store catalog.","directories":{},"_nodeVersion":"24.17.0","dependencies":{"@artos-commerce/ucp-client":"^0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.39.4","vitest":"^4.1.9","globals":"^17.7.0","prettier":"^3.8.3","@eslint/js":"^9.39.4","typescript":"^5.6.0","@types/node":"^22.19.0","typescript-eslint":"^8.62.0","@vitest/coverage-v8":"^4.1.9","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.6"},"_npmOperationalInternal":{"tmp":"tmp/ucp-cli_0.3.0_1782675123610_0.7485020942137917","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@artos-commerce/ucp-cli","version":"0.3.1","description":"Command-line tools for building agents on Artos: scaffold an agent UCP profile, run connectivity diagnostics, inspect a store's UCP profile, and search the cross-store catalog.","type":"module","license":"MIT","keywords":["artos","ucp","agent-commerce","cli","mcp","ap2"],"homepage":"https://docs.artos.sh","engines":{"node":">=22"},"bin":{"artos":"dist/index.js"},"scripts":{"build":"tsc -p tsconfig.json","lint":"eslint .","lint:fix":"eslint . --fix","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","typecheck":"tsc -p tsconfig.json --noEmit","check":"npm run lint && npm run typecheck && npm run test:coverage && npm run build","prepublishOnly":"npm run check"},"dependencies":{"@artos-commerce/ucp-client":"^0.5.0"},"devDependencies":{"@eslint/js":"^9.39.4","@types/node":"^22.19.0","@vitest/coverage-v8":"^4.1.9","eslint":"^9.39.4","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.6","globals":"^17.7.0","prettier":"^3.8.3","typescript":"^5.6.0","typescript-eslint":"^8.62.0","vitest":"^4.1.9"},"publishConfig":{"access":"public"},"gitHead":"bdddd9550aecfdec9983d28932b2ef6f7d9915ec","_id":"@artos-commerce/ucp-cli@0.3.1","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-D/FQrfDe6wTy1igHOfEo/wX3p9guedWNMC0ofAS51pQm/aKSHdS3zrBoRvoIU6gAa2za15+psR9VY5raNDZf2Q==","shasum":"f32dac184afe2de5b95a10f66118cb54138a6113","tarball":"https://registry.npmjs.org/@artos-commerce/ucp-cli/-/ucp-cli-0.3.1.tgz","fileCount":62,"unpackedSize":140576,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAuJ2UJ0iAX2kJNDws6uu55z1Vn6RvLylhev6/Vq27J8AiEAiOTuVd+A+bqZBTZ4u8bBjLRsSIOt6XJfqHsk1BS5wUA="}]},"_npmUser":{"name":"mkitsos","email":"mkitsos@gmail.com"},"directories":{},"maintainers":[{"name":"mkitsos","email":"mkitsos@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ucp-cli_0.3.1_1783802480660_0.2011604894482193"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-28T09:57:33.453Z","modified":"2026-07-11T20:41:20.925Z","0.1.0":"2026-06-28T09:57:33.745Z","0.1.1":"2026-06-28T13:31:27.896Z","0.1.2":"2026-06-28T13:37:50.950Z","0.1.3":"2026-06-28T13:45:48.102Z","0.2.0":"2026-06-28T18:51:14.429Z","0.2.1":"2026-06-28T19:01:38.914Z","0.3.0":"2026-06-28T19:32:03.747Z","0.3.1":"2026-07-11T20:41:20.789Z"},"license":"MIT","homepage":"https://docs.artos.sh","keywords":["artos","ucp","agent-commerce","cli","mcp","ap2"],"description":"Command-line tools for building agents on Artos: scaffold an agent UCP profile, run connectivity diagnostics, inspect a store's UCP profile, and search the cross-store catalog.","maintainers":[{"name":"mkitsos","email":"mkitsos@gmail.com"}],"readme":"# @artos-commerce/ucp-cli\n\nCommand-line tools for building **agents on Artos** (the Universal Commerce\nProtocol). Scaffold an agent UCP profile, run connectivity diagnostics, inspect a\nstore's UCP profile, search the cross-store catalog, and drive a full\ncart → checkout → purchase flow (plus buyer-account tools) — without hand-rolling\nthe UCP transport, headers, or signing.\n\nIt is the **Build track** companion to\n[`@artos-commerce/ucp-client`](https://www.npmjs.com/package/@artos-commerce/ucp-client):\nthe CLI uses the SDK under the hood. If you only want an agent (Claude, Cursor)\nto shop, use the hosted **Connect** bridge instead — see the\n[Artos agent docs](https://docs.artos.sh/agents).\n\n## Install\n\n```bash\nnpm install -g @artos-commerce/ucp-cli\n# or run ad hoc:\nnpx @artos-commerce/ucp-cli --help\n```\n\nRequires **Node 22+**. The crypto settlement rail's `@mysten/sui` is **not**\nneeded for any CLI command.\n\n## Configuration\n\nEvery command resolves its connection from flags first, then the environment,\nthen defaults:\n\n| Setting | Flag | Env | Default |\n| --- | --- | --- | --- |\n| Artos API base URL | `--api` | `ARTOS_BASE_URL` | `https://api.artos.sh` |\n| Platform API key | `--key` | `UCP_PLATFORM_API_KEY` | _(none — anonymous)_ |\n| Agent profile URL | `--profile` | `PLATFORM_PROFILE_URL` | _(none)_ |\n\nCatalog discovery is anonymous, so `catalog search` and `discover` work with no\nkey. **Cart, checkout, and purchase** need a real platform key\n(`UCP_PLATFORM_API_KEY`). **`purchase confirm`** additionally needs your agent\nsigning key (`AGENT_PRIVATE_JWK` + `AGENT_KID`) so it can mint the AP2 mandate,\nand **`account`** (and any buyer-bound call) needs a buyer OAuth bearer\n(`ARTOS_BUYER_BEARER`). The CLI settles the **card / $0** rails; for crypto\nsettlement, use the SDK directly.\n\n## Commands\n\n### `artos init [name]`\n\nScaffolds a runnable **Build-track** starter project: `package.json`,\n`tsconfig.json`, `.env.example`, and a `src/index.ts` wired with `UcpClient`,\n`createCheckoutHandlers`, `createAccountHandlers`, and `OAuthClient` (a\nsearch → checkout demo plus account-tool and buyer-OAuth examples). Refuses to\noverwrite a directory that already has a `package.json`.\n\n```bash\nartos init my-agent           # → ./my-agent\nartos init my-agent --out /path/to/dir\ncd my-agent && npm install && cp .env.example .env && npm start\n```\n\n### `artos profile init`\n\nGenerates an EC P-256 signing keypair and a UCP profile document.\n\n```bash\nartos profile init --out ./agent-profile --url https://your-app.example/.well-known/ucp\n```\n\nWrites `ucp.json` (host it publicly at the `--url`) and `private-jwk.json`\n(**secret** — load as `AGENT_PRIVATE_JWK`, never commit). Prints the env vars to\nexport.\n\n### `artos doctor`\n\nChecks your connection to Artos: platform key, the API's UCP discovery profile,\nthe OAuth Authorization Server metadata, and (when configured) your published\nagent profile. Exits non-zero on any failure.\n\n```bash\nartos doctor\nartos doctor --api https://api.dev.artos.sh --profile https://your-app.example/.well-known/ucp\n```\n\n### `artos conformance [--store <slug>]`\n\nRuns a battery of live UCP conformance checks against a deployment: the platform\ndiscovery profile and its declared UCP version, the OAuth metadata (endpoints,\nPKCE `S256`, `offline_access` / `purchase:complete` scopes), the cross-store\ncatalog search, the buyer-bound `401` + `WWW-Authenticate` relay contract, and —\nwhen a store is given — that the store publishes signing keys for AP2\nverification. Exits non-zero if any required check fails (warnings don't fail the\nrun), so it drops straight into CI. Add `--json` for a machine-readable report.\n\n```bash\nartos conformance --api https://api.dev.artos.sh --key \"$UCP_PLATFORM_API_KEY\"\nartos conformance --store acme --json\n```\n\n### `artos discover --store <slug>`\n\nFetches a store's UCP profile and prints its protocol version, signing keys,\npayment handlers, and capabilities.\n\n```bash\nartos discover --store about-you\nartos discover --store about-you --json\n```\n\n### `artos catalog search <query>`\n\nSearches the cross-store catalog with the correct UCP headers. `--max` is in\nmajor units (dollars) and is converted to minor units for you.\n\n```bash\nartos catalog search \"running shoes\" --max 150 --currency USD\nartos catalog search shoes --json\n```\n\n### `artos cart <create|view|update>`\n\nManages a store cart. `--item` is repeatable and takes a variant id with an\noptional `:quantity` (default 1).\n\n```bash\nartos cart create --store about-you --item <variantId>:2 --item <variantId>\nartos cart view   --store about-you --id <cartId>\nartos cart update --store about-you --id <cartId> --item <variantId>:3\n```\n\n### `artos checkout <create|view|update>`\n\nManages a store checkout. Build it from a cart (`--cart`) or line items\n(`--item`), and set nested fields with `--set` (dotted keys nest, e.g.\n`--set shipping_address.country=US`).\n\n```bash\nartos checkout create --store about-you --cart <cartId> --set shipping_address.country=US\nartos checkout view   --store about-you --id <checkoutId>\nartos checkout update --store about-you --id <checkoutId> --set buyer.email=you@example.com\n```\n\n### `artos product <view|get|lookup>`\n\nInspects products. `view` fetches one product at a store, `get` fetches one\nproduct over the cross-store catalog (no store needed), and `lookup` resolves one\nor more products by id / handle / SKU / barcode. `get` and `lookup` are anonymous\n(no key); `view` uses the store MCP transport.\n\n```bash\nartos product view   --store about-you --id <productId>\nartos product get    --id <productId>\nartos product lookup <productId> <productId> --json\n```\n\n### `artos order view`\n\nViews a store order by id (`get_order`, store-scoped). Reading orders needs a\nplatform key with the `orders:read` scope.\n\n```bash\nartos order view --store about-you --id <orderId>\n```\n\n### `artos purchase confirm`\n\nRe-prices the checkout, verifies the store's signed terms, mints the AP2\nmandate, and places the order on the **card / $0** rail. Needs\n`AGENT_PRIVATE_JWK` + `AGENT_KID`. Exit codes: `0` placed, `2` action required\n(escalation / pick a rail with `--pay`), `1` error.\n\n```bash\nartos purchase confirm --store about-you --id <checkoutId> --pay artos.card\nartos purchase confirm --store about-you --id <checkoutId> --no-coupon   # strip an attached coupon\n```\n\nCoupon **redemption** runs on the crypto rail only, so it is handled by the SDK,\nnot this card/$0 CLI — here only `--no-coupon` (which removes an attached coupon\nclaim before pricing) is meaningful.\n\n### `artos account <list|call> [tool]`\n\nLists or calls buyer-account tools. Buyer-bound, so it needs `ARTOS_BUYER_BEARER`.\nThe available tools are `get_buyer_context`, `list_my_addresses`,\n`list_my_orders`, `get_my_order`, `list_my_returns`, `get_wallet_balances`,\n`list_my_coupons`, `list_my_gifts`, and `claim_gift`.\n\n```bash\nartos account list\nartos account call list_my_orders --args '{\"limit\":5}'\nartos account call get_buyer_context --set verbose=true\n```\n\n## Development\n\n```bash\nnpm install\nnpm run check   # lint + typecheck + test:coverage + build\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}