@truthlock/protect

CLI tool for protecting code, research, designs, and digital content with cryptographic proofs of authorship.

Installation

npm install -g @truthlock/protect
# or run directly
npx @truthlock/protect

Quick Start

# Authenticate with your Truthlocks account
truthlock-protect login --token YOUR_TOKEN

# Protect a file
truthlock-protect protect ./my-project/main.ts

# Protect an entire directory
truthlock-protect protect ./src --category code

# List your protected content
truthlock-protect list

# Verify a protection
truthlock-protect verify <attestation-id>

Commands

| Command | Description | | ---------------- | ------------------------------------------------------ | | login | Authenticate with your Truthlocks account | | logout | Remove stored credentials | | whoami | Show current authenticated user | | protect <path> | Protect a file or directory with a cryptographic proof | | list | List your protected content | | verify <id> | Verify a protection by attestation ID |

Content Categories

When protecting content, you can specify a category:

• code -- Source code and scripts
• research -- Research papers and datasets
• design -- Design files and assets
• media -- Photos, videos, and audio
• document -- Documents and reports
• ai-output -- AI-generated content
• other -- Everything else

truthlock-protect protect ./paper.pdf --category research
truthlock-protect protect ./design.fig --category design

CI/CD Integration

Use in GitHub Actions:

- name: Protect source code
  run: npx @truthlock/protect protect ./src --category code
  env:
    TRUTHLOCK_TOKEN: ${{ secrets.TRUTHLOCK_TOKEN }}

Documentation

Full documentation: docs.truthlocks.com/guides/protect-cli

License

MIT