CredCLI turns HTML templates and a CSV spreadsheet into signed PDFs, verifiable badges, email bundles, and blockchain-stamped credentials — in seconds, from your terminal or browser.
CredCLI requires Node.js 18 or later. If you don't have Node installed, download it from nodejs.org first.
Use npx to run any CredCLI command without a global install. Node.js downloads the package on first run and caches it locally.
Install once and run credcli from anywhere on your machine. Recommended if you issue credentials regularly.
Verify your Node.js version with node --version before installing.
Node 18+ is required. Use nvm or nvm-windows to manage multiple Node versions.
Claim your Chainletter workspace token from a shortlink.
credcli register <url>
Pick a template, then drop in your recipient spreadsheet.
credcli new · csv
Headless Chromium renders every row as a PDF or PNG.
credcli run --format pdf
Assign a Chainletter collection, upload files, lock on-chain.
credcli assign · send · stamp
Generate ready-to-send .eml files and an MBOX archive.
credcli email
credcliClaim a Chainletter token from a shortlink and save it to .data/token.json. Use -i to inspect the current token (tenant, group, expiry).
Set your organization name and logo. The logo is base64-embedded in every credential automatically.
Create a new credential job interactively, or pre-select a template with --template. Jobs auto-increment (job001, job002…).
List all available templates with dimensions and the CSV column names they expect.
Load a recipient CSV into a job. Headers matched case-insensitively; column count is flexible.
Render credentials for every recipient via headless Chromium. Outputs to output/.
Show all jobs with template name, recipient count, and how many output files have been generated.
List the generated credential files for a job with absolute paths and file sizes.
Link a job to a Chainletter collection. Network defaults to private; pass public for open verification.
Upload rendered credentials to the assigned Chainletter collection. Fetches and stores claim links for emails.
Blockchain-stamp the collection, making it immutable. Records timestamp in job metadata.
Generate .eml files, an MBOX archive, and a manifest CSV. Chainletter claim links are injected automatically.
Start the web UI at localhost:3037 for visual template editing and live credential preview in your browser.
Show usage. -c writes a CLAUDE.md for Claude Code; -s writes SKILL.MD for agent workflows.
HTML templates with {{Placeholder}} merge tags. 21+ standard fields plus 12 transcript course rows per recipient.
Pixel-perfect rendering via Playwright Chromium. Print-to-PDF preserves backgrounds, fonts, and full-bleed layouts.
Auto-generates and embeds a QR code from QRUrl or VerificationURL on every credential.
One command locks the entire collection on-chain via Chainletter. Tamper-evident, verifiable forever.
Standards-compliant .eml files with PDF attachments, plain-text + HTML body, and an MBOX archive for bulk import.
Run credcli serve for a browser-based editor with live preview — no terminal required.
Drop a custom HTML file into your workspace templates folder and it appears in credcli templates automatically. Or define your own templates from scratch using whatever fields you want — any {{CustomField}} in your HTML becomes a column in your CSV.
Use any subset of these columns in your CSV. Unmatched columns are ignored; missing fields render as blank. Custom templates can add any fields they need — just match column names to your {{Placeholders}}.