@truthlocks/protect

Truthlocks content protection CLI — protect code, research, designs, and digital content with cryptographic proofs.

Install

npm install -g @truthlocks/protect

Get Started (Free — 10 Seconds, No Website)

# Step 1: Register (instant, no website, no credit card)
truthlocks register --email [email protected]
# → API key saved to ~/.truthlocks/credentials.json
# → Free tier: 100 protections/month

# Step 2: Protect your first file
truthlocks protect myfile.pdf
# → Protected! Attestation ID: att_abc123
# → Verify: https://verify.truthlocks.com?id=att_abc123
# → Usage: 1/100 attestations this month

All Ways to Register (No Website Needed)

# Via this CLI
truthlocks register --email [email protected]

# Via SDK (JavaScript)
const { apiKey } = await TruthlockClient.register({ email: '[email protected]' });

# Via VS Code
# Command Palette → "MAIP: Register Developer"

# Via MCP (Claude/ChatGPT)
# Call tool: truthlocks_register { email: "[email protected]" }

# Via Python
# await TruthlockClient.register("[email protected]")

# Via cURL
curl -X POST https://sandbox-api.truthlocks.com/v1/developers/register \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","source":"curl"}'

Commands

Register (get API key instantly)

truthlocks register --email [email protected]

Protect a file

truthlocks protect <file> [options]

Options:
  -a, --algorithm <alg>   Signing algorithm (default: Ed25519)
  -k, --api-key <key>     API key (or use ~/.truthlocks/credentials.json)
  -t, --title <title>     Title for the attestation
  --json                  Output as JSON

Verify an attestation

truthlocks verify --id att_abc123

Check who you are

truthlocks whoami

10 Signing Algorithms

truthlocks protect myfile.pdf --algorithm ES384    # Government/CNSA
truthlocks protect myfile.pdf --algorithm PS256    # Modern RSA
truthlocks protect myfile.pdf --algorithm Ed25519  # Default, fastest

All 10: Ed25519, ES256, ES384, ES512, RS256, RS384, RS512, PS256, PS384, PS512

Authentication Priority

1. --api-key flag
2. TRUTHLOCKS_API_KEY environment variable
3. ~/.truthlocks/credentials.json (saved by truthlocks register)

If none found: prompts you to run truthlocks register --email [email protected]

GitHub Action

- uses: truthlocks/maip-github-action@v1
  with:
    api-key: ${{ secrets.TRUTHLOCKS_API_KEY }}

Free Tier (No Credit Card)

• 100 protections/month
• 1,000 verifications
• All 10 algorithms
• Upgrade: console.truthlocks.com/upgrade

Documentation

• CLI Guide
• GitHub Action
• API Reference

License

MIT