@certivu/cli

Command-line tool for Certivu — sign and verify AI-generated content from your terminal.

Install

npm install -g @certivu/cli

certivu --version

Quick Start

# Save your API key
certivu config set api-key ctv_key_...
certivu config set generator-id your-generator-id

# Sign a file — images, audio, or text; format auto-detected
certivu sign ./output.jpg --model stable-diffusion-xl
certivu sign ./podcast.wav --model whisper-v3
certivu sign ./report.pdf --model gpt-4o --format text

# Verify a file
certivu verify ./output.jpg

# Look up a token
certivu status ctv_7f3kx9mq2...

Commands

certivu sign <file>

Sign AI-generated content. Signing, watermarking, and ML-DSA are all server-side — no private key required locally. Accepts images (JPEG/PNG/WebP), audio (MP3/FLAC/WAV), and text (PDF/HTML/plain text). Format is auto-detected from magic bytes; use --format to override.

certivu sign ./output.jpg --model stable-diffusion-xl
✓ Signed
  Token       ctv_7f3kx9mq2...
  Record ID   rec-00000000-...
  Format      image
  Output      ./output.signed.jpg

| Flag | Description | |------|-------------| | --model <name> | AI model name — required | | --format <type> | image, audio, or text — auto-detected if omitted | | --generator-id <id> | Override generator ID | | --output <path> | Output file path (default: <input>.signed.<ext>) | | --api-key <key> | Override API key |

certivu verify <file>

Verify content authenticity. Free — no API key required.

certivu verify ./output.jpg
✓ Authentic — HIGH confidence
  Org         Acme AI
  Model       stable-diffusion-xl
  Signed      2026-06-07T...
  Source      xmp

  Signals: watermark ✓  record ✓  signature ✓

| Flag | Description | |------|-------------| | --token <ctv_token> | Provide token explicitly (extracted automatically if omitted) |

certivu status <ctv_token>

Look up a token without re-uploading the file.

certivu config

certivu config set api-key ctv_key_abc123
certivu config set generator-id <uuid>
certivu config get

Config is stored at ~/.config/certivu/config.json. Environment variables (CERTIVU_API_KEY, CERTIVU_GENERATOR_ID, CERTIVU_BASE_URL) override the config file.

Requirements

Node.js 18 or later.

Links

• Dashboard
• Docs
• TypeScript SDK
• certivu.ai

License

Copyright (c) 2026 Certivu. All rights reserved.