{"_id":"@unpaper/cli","_rev":"4-b3ff8bbce6414768f9993cc26ebbdc8f","name":"@unpaper/cli","dist-tags":{"latest":"0.3.0"},"versions":{"0.0.1":{"name":"@unpaper/cli","version":"0.0.1","keywords":["unpaper","slides","powerpoint","pptx","presentation","deck","html","html-to-pptx","ai"],"author":{"name":"reHeritage GmbH"},"license":"UNLICENSED","_id":"@unpaper/cli@0.0.1","maintainers":[{"name":"unpaper","email":"accounts@unpaper.ai"}],"homepage":"https://www.unpaper.ai","bugs":{"url":"https://www.unpaper.ai"},"bin":{"unpaper":"bin/unpaper.mjs"},"dist":{"shasum":"926c3c9d6a2d768e85e8cd6118d40982ce8655bf","tarball":"https://registry.npmjs.org/@unpaper/cli/-/cli-0.0.1.tgz","fileCount":3,"integrity":"sha512-XOzkA5trjYz1PyGI4nKCDXvq9PRYitmOe+FHU2Tqwr1sX7lyukupv/7d8qudDg0Su01A6X54x4ONc1auT8tnCg==","signatures":[{"sig":"MEYCIQC/uCWkOLe1pmq82R1tA2QX1HnTzfow/kEbNV5XMAE8xwIhAIgXVbj8ENQ83UgpLcN2sA5mJ/uL4KF1W/3j6N1+nMaY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1651},"type":"module","engines":{"node":">=18"},"_npmUser":{"name":"unpaper","email":"accounts@unpaper.ai"},"_npmVersion":"11.8.0","description":"unPaper CLI — ask any AI for print-ready HTML, get an editable PowerPoint. Runs in your browser at unpaper.ai; the CLI is on the roadmap.","directories":{},"_nodeVersion":"24.13.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cli_0.0.1_1783288488331_0.18541749106679095","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@unpaper/cli","version":"0.2.0","author":{"name":"reHeritage GmbH"},"license":"SEE LICENSE IN LICENSE","_id":"@unpaper/cli@0.2.0","maintainers":[{"name":"unpaper","email":"accounts@unpaper.ai"}],"homepage":"https://www.unpaper.ai","bin":{"unpaper":"bin/unpaper.mjs"},"dist":{"shasum":"ee1fd6cabc450f8dbd9efc4cc11879579c9a9c5e","tarball":"https://registry.npmjs.org/@unpaper/cli/-/cli-0.2.0.tgz","fileCount":33,"integrity":"sha512-Z5v5I4v71XlcbYsO92R2fxiwXg2+/U29Ek70OHy+gETOgoHXmMY2XPpuWC9FTb1kVvVAOzJ36KWbdEsRy52vvQ==","signatures":[{"sig":"MEQCIGlbCD8MhRF4IUdBmKTw1NsLvzz784rzpGrT+LnIkvYQAiBOZ8w/tImT677VCjY1okzQxEH/Es/tbsSbfdZN5YNwBg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":831393},"type":"module","engines":{"node":">=18"},"gitHead":"e56168667ef40ea15e815ca7b4c9c280cf826424","scripts":{"build":"node build.mjs"},"_npmUser":{"name":"unpaper","email":"accounts@unpaper.ai"},"_npmVersion":"11.16.0","description":"unPaper on your machine: convert self-contained HTML decks to real, editable PowerPoint; validate conformance; get starter templates and the pattern library. Local, offline, no AI inside. A product of reHeritage GmbH.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.24.0","jszip":"^3.10.1","pptxgenjs":"^4.0.1","puppeteer-core":"^25.1.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.24.0"},"_npmOperationalInternal":{"tmp":"tmp/cli_0.2.0_1784359351527_0.0942305352483912","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@unpaper/cli","version":"0.2.1","author":{"name":"reHeritage GmbH"},"license":"SEE LICENSE IN LICENSE","_id":"@unpaper/cli@0.2.1","maintainers":[{"name":"unpaper","email":"accounts@unpaper.ai"}],"homepage":"https://www.unpaper.ai","bin":{"unpaper":"bin/unpaper.mjs"},"dist":{"shasum":"a11e694a775f2bc5d5caeb62a130a87c82318983","tarball":"https://registry.npmjs.org/@unpaper/cli/-/cli-0.2.1.tgz","fileCount":33,"integrity":"sha512-bDPSRoLs7en8LqQoqSVhkfERZUZtEnCde6ikt5WyUXGnEGcdPRnF2zHeIbSHFhfDsEGACYBMg2oBkX0ZhhafeQ==","signatures":[{"sig":"MEUCIEwOJIeNqTOQ4dkxHno6BUa8egqYkU+c8T+yuUH4wGsqAiEAyab1D6TMe1zDFaVEgFYTRMWiIn4ay+DE/aCJzGBmDXo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":831424},"type":"module","engines":{"node":">=18"},"gitHead":"0931f3b21f21c05499322dbfa7a49cdbe5fe7f19","mcpName":"ai.unpaper/cli","scripts":{"build":"node build.mjs"},"_npmUser":{"name":"unpaper","email":"accounts@unpaper.ai"},"_npmVersion":"11.16.0","description":"unPaper on your machine: convert self-contained HTML decks to real, editable PowerPoint; validate conformance; get starter templates and the pattern library. Local, offline, no AI inside. A product of reHeritage GmbH.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.24.0","jszip":"^3.10.1","pptxgenjs":"^4.0.1","puppeteer-core":"^25.1.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"esbuild":"^0.24.0"},"_npmOperationalInternal":{"tmp":"tmp/cli_0.2.1_1784360564417_0.29540234536583965","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@unpaper/cli","version":"0.3.0","mcpName":"ai.unpaper/cli","description":"unPaper on your machine: convert self-contained HTML decks to real, editable PowerPoint; validate conformance; get starter templates and the pattern library. Local, offline, no AI inside. A product of reHeritage GmbH.","license":"SEE LICENSE IN LICENSE","author":{"name":"reHeritage GmbH"},"homepage":"https://www.unpaper.ai","type":"module","bin":{"unpaper":"bin/unpaper.mjs"},"engines":{"node":">=18"},"scripts":{"build":"node build.mjs"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","jszip":"^3.10.1","pptxgenjs":"^4.0.1","puppeteer-core":"^25.1.0","zod":"^3.24.0"},"devDependencies":{"esbuild":"^0.24.0"},"gitHead":"55ae1e268288cf4e2a6dcefb737389b1a1218de9","_id":"@unpaper/cli@0.3.0","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-LGW2VMKSeq69d4ZtZUd3IwJFioe/Q1BxwA4cNrczZdSVONW5hlPmFiy6z9lLWcj8QJsvLBvUkhwpc2GOX4Mr6Q==","shasum":"a5830c46759ab9dac2249f01a8ce1c7d9b4d65b1","tarball":"https://registry.npmjs.org/@unpaper/cli/-/cli-0.3.0.tgz","fileCount":34,"unpackedSize":926150,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHzhs5l8N8eq62Fr3JCGStlip6EiHg9tH53WsV8+sElhAiA3ikwB4psIUE1a/TTtTES5c2bq5m7W0frs68LxEAn3jg=="}]},"_npmUser":{"name":"unpaper","email":"accounts@unpaper.ai"},"directories":{},"maintainers":[{"name":"unpaper","email":"accounts@unpaper.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_0.3.0_1786011178290_0.5087451573415767"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-05T21:54:48.173Z","modified":"2026-08-06T10:12:58.662Z","0.0.1":"2026-07-05T21:54:48.459Z","0.2.0":"2026-07-18T07:22:31.653Z","0.2.1":"2026-07-18T07:42:44.684Z","0.3.0":"2026-08-06T10:12:58.491Z"},"author":{"name":"reHeritage GmbH"},"license":"SEE LICENSE IN LICENSE","homepage":"https://www.unpaper.ai","description":"unPaper on your machine: convert self-contained HTML decks to real, editable PowerPoint; validate conformance; get starter templates and the pattern library. Local, offline, no AI inside. A product of reHeritage GmbH.","maintainers":[{"name":"unpaper","email":"accounts@unpaper.ai"}],"readme":"# @unpaper/cli\n\nunPaper on your machine: turn self-contained HTML decks into **real, editable\nPowerPoint**, validate conformance, get starter templates and the pattern\nlibrary — and expose it all to AI agents over MCP. **Local, offline, no AI\ninside.** A product of [reHeritage GmbH](https://www.unpaper.ai).\n\n```\nnpx @unpaper/cli starter --family consulting -o deck.html\n# …your AI writes content into deck.html…\nnpx @unpaper/cli check deck.html          # L0–L3 conformance, exit 0/1\nnpx @unpaper/cli convert deck.html        # → deck.pptx, fully editable\n```\n\n## What you need\n\n- **Node ≥ 18.**\n- **A local Chrome, Chromium or Edge** (for `convert` only — the deck is\n  measured in a real browser). Discovery order: `--browser <path>` →\n  `UNPAPER_BROWSER`/`CHROME_PATH` env → standard install locations.\n  `check`, `starter` and `patterns` need no browser.\n- Optional: **LibreOffice** enables `import` for legacy `.ppt`/`.pps`/`.odp`.\n\nEverything runs on your machine. No network calls, no telemetry, no upload,\nno AI. Your documents never leave your computer.\n\n## Commands\n\n| Command | What it does |\n| --- | --- |\n| `convert <deck.html> [-o out.pptx] [--selector .slide] [--no-shapes] [--json]` | HTML deck → .pptx with native text boxes, real tables, data-editable charts, movable shapes, speaker notes. Foreign (non-unPaper) fixed-size decks convert too via selector auto-detection. |\n| `check <deck.html> [--json]` | Conformance level **L0–L3** + issues + a ready fix-request. **Exit code contract (CI-usable): `0` = level ≥ L1 and no errors, `1` otherwise.** |\n| `check <tpl.html> --template [--family <f>] [-o repaired.html]` | Validate a **company template** against the byte-law: per-rule checks, mechanical re-lock of a drifted sizing script, fix request on failure. Base family auto-detects; same exit contract. |\n| `starter [--family standard\\|consulting\\|design\\|editorial] [-o f.html]` | Print a ready-to-fill template (self-contained, print-ready). |\n| `templatize [-o payload.txt]` | The **company-template payload** for *your* AI. No flags = re-skin mode (attach the company's real slides in your AI). Brief flags (`--name`, `--does`, `--personality modern\\|classic\\|technical\\|warm\\|bold`, `--colors \"#a,#b\"`, `--logo file.svg`, `--foot`, `--present proposals,strategy,research,sales,board`, `--notes`) = from-scratch design mode; `--founded start.html` also writes the pre-founded base — already a valid template on its own. |\n| `patterns [family\\|ID]` | The pattern library: 90+ slide patterns with jobs, converter status, prompt fragments. |\n| `import <deck.pptx\\|ppt\\|odp> [--emit-verbatim] [--emit-brand-kit]` | Rescue an existing deck into AI-readable unPaper HTML (content, tables, notes, chart data, image registry). Legacy formats elevate via local LibreOffice. |\n| `rehydrate <redesign.html> <images.json> -o final.html` | Splice the real images back into an AI's redesign, by id, deterministically. |\n| `mcp` | Run the stdio MCP server (below). |\n\n## MCP server (for Claude Code, Claude Desktop, Cursor…)\n\n```jsonc\n// Claude Code (.mcp.json) / Claude Desktop (claude_desktop_config.json)\n{ \"mcpServers\": { \"unpaper\": { \"command\": \"npx\",\n    \"args\": [\"-y\", \"@unpaper/cli\", \"mcp\"] } } }\n```\n\nCursor (`~/.cursor/mcp.json`) and any generic stdio client take the same\n`command`/`args` pair.\n\nSeven tools: `starter → check → convert` (the happy path — an agent goes\nbrief → deck → validated → .pptx with zero copy-paste), plus `patterns`,\n`import`/`rehydrate` for redesigning existing PowerPoints, and `templatize`\nfor a company's own reusable format (the agent executes the returned payload\nitself, then validates with `check {template: true}` — there is no\ngeneration inside unPaper). Set a client timeout of **≥ 120 s** — big decks\ntake time to measure and build. Browser discovery honors `UNPAPER_BROWSER`.\nAll server logging goes to stderr.\n\n## License\n\nSee `LICENSE`. Version 0.3.0 is free for individual use, including work for an\nemployer or client, and for a five-person/60-day organization evaluation. An\nannual commercial licence is required for central organization adoption,\nshared CI or agent automation, or managed distribution for more than five\nauthorized users. Private deployment, embedding and resale are licensed\nseparately.\n\nThere is no user, document, prompt or conversion metering and no phone-home\nlicence check. Version 0.2.1 retains the broader licence distributed with that\nrelease. The unPaper HTML **format specification** remains open (CC BY 4.0):\nhttps://www.unpaper.ai/spec\n","readmeFilename":"README.md"}